25 - the definitions §11 held sit at the code, and §8 says only what the README does not

src/markdown/commonmark/emphasis-matching.ts

@@ -27,6 +27,7 @@ export function isWordCharacter(character: string): boolean {
   return character !== '' && !isWhitespace(character) && !isPunctuation(character)
 }
 
+// Transcribes CommonMark's reference process_emphasis line for line; the closer walk and opener search stay whole, since named steps drift from it.
 export function matchEmphasis<Run extends DelimiterRun>(runs: readonly Run[]): EmphasisPairing<Run>[] {
   const pairings: EmphasisPairing<Run>[] = []
   const bottoms = new Map<string, Candidate<Run> | undefined>()

src/markdown/emit/inline-line.ts

@@ -65,6 +65,7 @@ export function tryImageLine(alt: string | undefined, href: string, path: Conver
 
 function emitLine(nodes: readonly AdfNode[], container: LineContainer, path: ConvertErrorPath): Result<EmittedLine> {
   const fallbacks: LineFallbacks = { carried: new Set(), openingLinkAsDirective: false }
+  // Terminates because takeFallback refuses a pass that took no new fallback.
   for (;;) {
     const emission = lineSegments(nodes, container, path, fallbacks)
     if (!emission.ok) return emission

src/nesting.ts

@@ -1,2 +1,2 @@
-// Levels count per AGENTS.md §11.
+// A level is one block-list recursion in either direction: a readable list's items sit one below it, its directive spelling's two.
 export const largestNesting = 500