agents-reverse-engineer 0.3.6 → 0.4.0

package/dist/generation/prompts/builder.js

@@ -1,5 +1,16 @@
 import * as path from 'node:path';
-import { getTemplate } from './templates.js';
+import { readdir, readFile } from 'node:fs/promises';
+import pc from 'picocolors';
+import { getTemplate, DIRECTORY_SYSTEM_PROMPT } from './templates.js';
+import { readSumFile, getSumPath } from '../writers/sum.js';
+const DEBUG = process.env.DEBUG_PROMPTS === '1' || process.env.DEBUG === '1';
+function logTemplate(action, filePath, fileType, extra) {
+    if (!DEBUG)
+        return;
+    const rel = path.relative(process.cwd(), filePath);
+    const msg = `${pc.dim('[prompt]')} ${pc.cyan(action)} ${pc.bold(fileType)} ${pc.dim('→')} ${rel}`;
+    console.error(extra ? `${msg} ${pc.dim(extra)}` : msg);
+}
 /**
  * Detect language from file extension for syntax highlighting.
  */
@@ -56,6 +67,7 @@ export function buildPrompt(context) {
     const template = getTemplate(context.fileType);
     const lang = detectLanguage(context.filePath);
     const framework = detectFramework(context.content);
+    logTemplate('buildPrompt', context.filePath, context.fileType, `lang=${lang} framework=${framework}`);
     let userPrompt = template.userPrompt
         .replace(/\{\{FILE_PATH\}\}/g, context.filePath)
         .replace(/\{\{CONTENT\}\}/g, context.content)
@@ -79,6 +91,7 @@ export function buildPrompt(context) {
 export function buildChunkPrompt(context) {
     const template = getTemplate(context.fileType);
     const lang = detectLanguage(context.filePath);
+    logTemplate('buildChunkPrompt', context.filePath, context.fileType, `chunk=${context.chunkIndex + 1}/${context.totalChunks} lines=${context.lineRange.start}-${context.lineRange.end}`);
     const system = `${template.systemPrompt}
 
 This is chunk ${context.chunkIndex + 1} of ${context.totalChunks} from a large file.
@@ -106,6 +119,7 @@ Keep it concise - this will be combined with other chunks.`;
  */
 export function buildSynthesisPrompt(context) {
     const template = getTemplate(context.fileType);
+    logTemplate('buildSynthesisPrompt', context.filePath, context.fileType, `chunks=${context.chunkSummaries.length}`);
     const system = `${template.systemPrompt}
 
 You are synthesizing chunk summaries into a final, cohesive summary.`;
@@ -133,4 +147,66 @@ Focus on:
 ${template.focusAreas.map((area) => `- ${area}`).join('\n')}`;
     return { system, user };
 }
+/**
+ * Build a prompt for generating a directory-level AGENTS.md.
+ *
+ * Reads all .sum files in the directory, child AGENTS.md files,
+ * and AGENTS.local.md to provide full context to the LLM.
+ */
+export async function buildDirectoryPrompt(dirPath, projectRoot) {
+    const relativePath = path.relative(projectRoot, dirPath) || '.';
+    const dirName = path.basename(dirPath) || 'root';
+    // Collect .sum file summaries
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    const fileSummaries = [];
+    const subdirSections = [];
+    for (const entry of entries) {
+        const entryPath = path.join(dirPath, entry.name);
+        if (entry.isFile() && !entry.name.endsWith('.sum') && !entry.name.startsWith('.')) {
+            const sumPath = getSumPath(entryPath);
+            const sumContent = await readSumFile(sumPath);
+            if (sumContent) {
+                fileSummaries.push(`### ${entry.name}\n**Type:** ${sumContent.fileType}\n**Purpose:** ${sumContent.metadata.purpose}\n\n${sumContent.summary}`);
+            }
+        }
+        if (entry.isDirectory()) {
+            // Read child AGENTS.md if it exists (post-order means it's already generated)
+            const childAgentsPath = path.join(entryPath, 'AGENTS.md');
+            try {
+                const childContent = await readFile(childAgentsPath, 'utf-8');
+                subdirSections.push(`### ${entry.name}/\n${childContent}`);
+            }
+            catch {
+                subdirSections.push(`### ${entry.name}/\n(no AGENTS.md yet)`);
+            }
+        }
+    }
+    // Check for user-defined AGENTS.local.md
+    let localSection = '';
+    try {
+        const localContent = await readFile(path.join(dirPath, 'AGENTS.local.md'), 'utf-8');
+        localSection = `\n## User Notes (AGENTS.local.md)\n\n${localContent}\n\nNote: Reference [AGENTS.local.md](./AGENTS.local.md) for additional documentation.`;
+    }
+    catch {
+        // No local file
+    }
+    logTemplate('buildDirectoryPrompt', dirPath, 'directory', `files=${fileSummaries.length} subdirs=${subdirSections.length}`);
+    const userSections = [
+        `Generate AGENTS.md for directory: "${relativePath}" (${dirName})`,
+        '',
+        `## File Summaries (${fileSummaries.length} files)`,
+        '',
+        ...fileSummaries,
+    ];
+    if (subdirSections.length > 0) {
+        userSections.push('', '## Subdirectories', '', ...subdirSections);
+    }
+    if (localSection) {
+        userSections.push(localSection);
+    }
+    return {
+        system: DIRECTORY_SYSTEM_PROMPT,
+        user: userSections.join('\n'),
+    };
+}
 //# sourceMappingURL=builder.js.map

package/dist/generation/prompts/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/generation/prompts/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,OAAO,GAA2B;QACtC,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,MAAM;KAChB,CAAC;IACF,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACzE,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACrE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAsB;IAIhD,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnD,IAAI,UAAU,GAAG,QAAQ,CAAC,UAAU;SACjC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,QAAQ,CAAC;SAC/C,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAC;SAC5C,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC;SAC9B,OAAO,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;IAE5C,gCAAgC;IAChC,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY;aACxC,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,SAAS,CAAC,CAAC,IAAI,WAAW,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,UAAU,CAC3E;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,UAAU,IAAI,yBAAyB,cAAc,EAAE,CAAC;IAC1D,CAAC;IAED,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,YAAY;QAC7B,IAAI,EAAE,UAAU;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IAIpD,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY;;gBAEzB,OAAO,CAAC,UAAU,GAAG,CAAC,OAAO,OAAO,CAAC,WAAW;yEACS,CAAC;IAExE,MAAM,IAAI,GAAG;;QAEP,OAAO,CAAC,QAAQ,WAAW,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG;SAC1E,OAAO,CAAC,UAAU,GAAG,CAAC,OAAO,OAAO,CAAC,WAAW;;QAEjD,IAAI;EACV,OAAO,CAAC,OAAO;;;;;;;;;2DAS0C,CAAC;IAE1D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAyB;IAI5D,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY;;qEAE4B,CAAC;IAEpE,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc;SACxC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC;SACrD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,IAAI,GAAG;;QAEP,OAAO,CAAC,QAAQ;aACX,OAAO,CAAC,QAAQ;;;;EAI3B,YAAY;;;;;;;;4BAQc,OAAO,CAAC,QAAQ;;;EAG1C,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAE5D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/generation/prompts/builder.ts"],"names":[],"mappings":"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"}

package/dist/generation/prompts/index.d.ts

@@ -1,5 +1,5 @@
 export type { PromptTemplate, PromptContext, ChunkContext, SynthesisContext, } from './types.js';
 export { SUMMARY_GUIDELINES } from './types.js';
 export { TEMPLATES, getTemplate } from './templates.js';
-export { buildPrompt, buildChunkPrompt, buildSynthesisPrompt, detectLanguage, detectFramework, } from './builder.js';
+export { buildPrompt, buildChunkPrompt, buildSynthesisPrompt, buildDirectoryPrompt, detectLanguage, detectFramework, } from './builder.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/generation/prompts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generation/prompts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generation/prompts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/generation/prompts/index.js

@@ -1,4 +1,4 @@
 export { SUMMARY_GUIDELINES } from './types.js';
 export { TEMPLATES, getTemplate } from './templates.js';
-export { buildPrompt, buildChunkPrompt, buildSynthesisPrompt, detectLanguage, detectFramework, } from './builder.js';
+export { buildPrompt, buildChunkPrompt, buildSynthesisPrompt, buildDirectoryPrompt, detectLanguage, detectFramework, } from './builder.js';
 //# sourceMappingURL=index.js.map

package/dist/generation/prompts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generation/prompts/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generation/prompts/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/generation/prompts/templates.d.ts

@@ -8,4 +8,9 @@ export declare const TEMPLATES: Record<FileType, PromptTemplate>;
  * Get the prompt template for a file type.
  */
 export declare function getTemplate(fileType: FileType): PromptTemplate;
+/**
+ * System prompt for directory-level AGENTS.md generation.
+ * Used by buildDirectoryPrompt() in builder.ts.
+ */
+export declare const DIRECTORY_SYSTEM_PROMPT = "You are generating an AGENTS.md file \u2014 a directory-level overview for AI coding assistants.\n\nCRITICAL: Output ONLY the raw markdown content. No code fences, no preamble, no explanations, no conversational text. Your entire response IS the AGENTS.md file content.\n\nOUTPUT FORMAT:\n- First line MUST be exactly: <!-- Generated by agents-reverse-engineer -->\n- Use a # heading with the directory name\n- Write a one-paragraph purpose statement for the directory\n- Group files by purpose/category under ## Contents with ### subheadings\n- For each file: markdown link [filename](./filename) and a one-line description\n- If subdirectories exist, list them under ## Subdirectories with links and brief summaries\n- End with ## How Files Relate \u2014 2-3 sentences synthesizing how the files collaborate\n\nDENSITY RULES (MANDATORY):\n- Every sentence must reference at least one specific identifier (function name, class name, type name, or constant)\n- Never use filler phrases: \"this directory\", \"this module\", \"provides\", \"responsible for\", \"is used to\"\n- Use technical shorthand: \"exports X, Y, Z\" not \"this module exports a function called X...\"\n- Maximum 500 words. Every word must earn its place.\n\nCOMMON PATTERNS (MANDATORY):\n- Identify recurring patterns shared by files in the directory (e.g., all files export a factory, all use a shared base class, all follow request/response pairs)\n- Name patterns explicitly (e.g., \"Strategy pattern\", \"Barrel re-export\", \"Builder pattern\")\n- If all files follow the same structure, state it once concisely\n\nLIBRARY & DEPENDENCY STATISTICS (MANDATORY):\n- Aggregate library usage across all files in the directory\n- List each external library with total usage count (e.g., \"zod (used in 4/7 files)\")\n- For Node built-ins, note which specific APIs are used\n- Group: external packages first, then node built-ins\n\nDISCOVERABLE CONTENT:\n- When files share patterns, stack choices, or structural conventions worth documenting in detail, suggest supplementary files\n- Use relative links: [PATTERNS.md](./PATTERNS.md), [STACK.md](./STACK.md), [STRUCTURE.md](./STRUCTURE.md)\n- Possible supplementary files:\n  - PATTERNS.md \u2014 recurring design/architectural patterns\n  - STACK.md \u2014 libraries and tools with rationale\n  - STRUCTURE.md \u2014 directory layout conventions and naming rules\n  - Any other relevant *.md (e.g., CONVENTIONS.md, API.md, TESTING.md)\n- Keep AGENTS.md as the entry point; don't duplicate supplementary content";
 //# sourceMappingURL=templates.d.ts.map

package/dist/generation/prompts/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/generation/prompts/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA8OjD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,CAYtD,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAE9D"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/generation/prompts/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA0RjD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,CAYtD,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAE9D;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,w+EAsCuC,CAAC"}

package/dist/generation/prompts/templates.js

@@ -1,12 +1,56 @@
 const BASE_SYSTEM_PROMPT = `You are analyzing source code to generate documentation for AI coding assistants.
 
-Guidelines:
-- Be concise but comprehensive (300-500 words)
-- Focus on what the code DOES and HOW to use it
-- Include key function signatures as code snippets
-- Note dependencies and their purposes
-- Mention only critical TODOs (security, breaking issues)
-- Reference tightly coupled files (used together)`;
+OUTPUT FORMAT:
+- Lead with a single-line purpose statement (what this file IS, not what it does)
+- List all public exports with their type signatures
+- For each export: one sentence explaining its role
+- End with dependencies and coupled files
+
+DENSITY RULES (MANDATORY):
+- Every sentence must reference at least one specific identifier (function name, class name, type name, or constant)
+- Never use filler phrases: "this file", "this module", "provides", "responsible for", "is used to", "basically", "essentially", "provides functionality for"
+- Use the pattern: "[ExportName] does X" not "The ExportName function is responsible for doing X"
+- Use technical shorthand: "exports X, Y, Z" not "this module exports a function called X..."
+- Compress descriptions: "parses YAML frontmatter from .sum files" not "responsible for the parsing of YAML-style frontmatter..."
+- Maximum 300 words. Every word must earn its place.
+
+ANCHOR TERM PRESERVATION (MANDATORY):
+- All exported function/class/type/const names MUST appear in the summary exactly as written in source
+- Key parameter types and return types MUST be mentioned
+- Preserve exact casing of identifiers (e.g., buildAgentsMd, not "build agents md")
+- Missing any exported identifier is a failure
+
+COMMON PATTERNS (MANDATORY):
+- Identify recurring patterns shared by files at the same directory level (e.g., all files export a factory, all use a shared base class, all follow request/response pairs)
+- Name the pattern explicitly (e.g., "Strategy pattern", "Barrel re-export", "Builder pattern", "Middleware chain")
+- If sibling files follow the same structure, state it once concisely: "All files in this directory follow the [pattern] pattern"
+
+LIBRARY & DEPENDENCY STATISTICS (MANDATORY):
+- List each imported library/package with a usage count across the file (e.g., "zod (3 usages: schema, parse, infer)")
+- For Node built-ins, note which specific APIs are used (e.g., "node:path (join, resolve, extname)")
+- Group: external packages first, then node built-ins, then local imports
+
+DISCOVERABLE CONTENT:
+- When a directory contains files that share patterns, stack choices, or structural conventions, recommend splitting documentation into supplementary files rather than cramming everything into AGENTS.md
+- Use relative links to point to supplementary docs: [PATTERNS.md](./PATTERNS.md), [STACK.md](./STACK.md), [STRUCTURE.md](./STRUCTURE.md)
+- Suggest supplementary files when appropriate:
+  - PATTERNS.md — recurring design/architectural patterns across sibling files
+  - STACK.md — libraries, frameworks, and tools used with version constraints and rationale
+  - STRUCTURE.md — directory layout conventions, naming rules, file organization
+  - Any other relevant *.md (e.g., CONVENTIONS.md, API.md, TESTING.md)
+- Keep AGENTS.md as the entry point that links out to these files; don't duplicate their content
+
+WHAT TO INCLUDE:
+- All exported function/class/type/const names
+- Parameter types and return types for public functions
+- Key dependencies and what they're used for
+- Coupled sibling files
+- Only critical TODOs (security, breaking issues)
+
+WHAT TO EXCLUDE:
+- Internal implementation details
+- Generic descriptions without identifiers
+- Filler phrases and transitions`;
 const COMPONENT_TEMPLATE = {
     fileType: 'component',
     systemPrompt: BASE_SYSTEM_PROMPT,
@@ -244,4 +288,47 @@ export const TEMPLATES = {
 export function getTemplate(fileType) {
     return TEMPLATES[fileType];
 }
+/**
+ * System prompt for directory-level AGENTS.md generation.
+ * Used by buildDirectoryPrompt() in builder.ts.
+ */
+export const DIRECTORY_SYSTEM_PROMPT = `You are generating an AGENTS.md file — a directory-level overview for AI coding assistants.
+
+CRITICAL: Output ONLY the raw markdown content. No code fences, no preamble, no explanations, no conversational text. Your entire response IS the AGENTS.md file content.
+
+OUTPUT FORMAT:
+- First line MUST be exactly: <!-- Generated by agents-reverse-engineer -->
+- Use a # heading with the directory name
+- Write a one-paragraph purpose statement for the directory
+- Group files by purpose/category under ## Contents with ### subheadings
+- For each file: markdown link [filename](./filename) and a one-line description
+- If subdirectories exist, list them under ## Subdirectories with links and brief summaries
+- End with ## How Files Relate — 2-3 sentences synthesizing how the files collaborate
+
+DENSITY RULES (MANDATORY):
+- Every sentence must reference at least one specific identifier (function name, class name, type name, or constant)
+- Never use filler phrases: "this directory", "this module", "provides", "responsible for", "is used to"
+- Use technical shorthand: "exports X, Y, Z" not "this module exports a function called X..."
+- Maximum 500 words. Every word must earn its place.
+
+COMMON PATTERNS (MANDATORY):
+- Identify recurring patterns shared by files in the directory (e.g., all files export a factory, all use a shared base class, all follow request/response pairs)
+- Name patterns explicitly (e.g., "Strategy pattern", "Barrel re-export", "Builder pattern")
+- If all files follow the same structure, state it once concisely
+
+LIBRARY & DEPENDENCY STATISTICS (MANDATORY):
+- Aggregate library usage across all files in the directory
+- List each external library with total usage count (e.g., "zod (used in 4/7 files)")
+- For Node built-ins, note which specific APIs are used
+- Group: external packages first, then node built-ins
+
+DISCOVERABLE CONTENT:
+- When files share patterns, stack choices, or structural conventions worth documenting in detail, suggest supplementary files
+- Use relative links: [PATTERNS.md](./PATTERNS.md), [STACK.md](./STACK.md), [STRUCTURE.md](./STRUCTURE.md)
+- Possible supplementary files:
+  - PATTERNS.md — recurring design/architectural patterns
+  - STACK.md — libraries and tools with rationale
+  - STRUCTURE.md — directory layout conventions and naming rules
+  - Any other relevant *.md (e.g., CONVENTIONS.md, API.md, TESTING.md)
+- Keep AGENTS.md as the entry point; don't duplicate supplementary content`;
 //# sourceMappingURL=templates.js.map

package/dist/generation/prompts/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/generation/prompts/templates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/generation/prompts/templates.ts"],"names":[],"mappings":"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"}

package/dist/generation/prompts/types.d.ts

@@ -35,8 +35,8 @@ export interface PromptContext {
 export declare const SUMMARY_GUIDELINES: {
     /** Target word count range */
     readonly targetLength: {
-        readonly min: 300;
-        readonly max: 500;
+        readonly min: 200;
+        readonly max: 300;
     };
     /** What to include */
     readonly include: readonly ["Purpose and responsibility", "Public interface (exports, key functions)", "Key patterns and notable algorithms", "Dependencies with usage context", "Key function signatures as code snippets", "Tightly coupled sibling files"];

package/dist/generation/prompts/types.js

@@ -3,7 +3,7 @@
  */
 export const SUMMARY_GUIDELINES = {
     /** Target word count range */
-    targetLength: { min: 300, max: 500 },
+    targetLength: { min: 200, max: 300 },
     /** What to include */
     include: [
         'Purpose and responsibility',

package/dist/generation/writers/agents-md.d.ts

@@ -1,69 +1,13 @@
 /**
- * Reference to a file in a directory.
- */
-export interface FileRef {
-    /** File name */
-    name: string;
-    /** Brief description from .sum file */
-    description: string;
-    /** Whether this is a critical/frequently modified file */
-    critical?: boolean;
-}
-/**
- * Group of files by purpose.
- */
-export interface FileGroup {
-    /** Purpose/category of this group */
-    purpose: string;
-    /** Files in this group */
-    files: FileRef[];
-}
-/**
- * Summary of a subdirectory.
- */
-export interface SubdirSummary {
-    /** Directory name */
-    name: string;
-    /** Brief summary (from child AGENTS.md or inferred) */
-    summary: string;
-}
-/**
- * Complete directory documentation structure.
- */
-export interface DirectoryDoc {
-    /** Directory path (relative to project root) */
-    path: string;
-    /** Directory description */
-    description: string;
-    /** Files grouped by purpose */
-    files: FileGroup[];
-    /** Subdirectories with summaries */
-    subdirectories: SubdirSummary[];
-    /** Related directories (from imports, config) */
-    relatedDirectories: string[];
-    /** Patterns/conventions in this directory */
-    patterns: string[];
-}
-/**
- * Build AGENTS.md content from directory documentation.
- *
- * @param doc - Directory documentation
- * @param hasLocalFile - Whether AGENTS.local.md exists (user-defined content)
- */
-export declare function buildAgentsMd(doc: DirectoryDoc, hasLocalFile?: boolean): string;
-/**
- * Build directory documentation from .sum files.
- */
-export declare function buildDirectoryDoc(dirPath: string, projectRoot: string): Promise<DirectoryDoc>;
-/**
- * Write AGENTS.md for a directory.
+ * Write AGENTS.md for a directory with LLM-generated content.
  *
  * If a user-defined AGENTS.md exists (not generated by us), it will be
  * preserved as AGENTS.local.md and referenced in the generated file.
  *
  * @param dirPath - Directory to write AGENTS.md for
  * @param projectRoot - Project root for relative paths
+ * @param content - LLM-generated AGENTS.md content
  * @returns Path to written AGENTS.md
  */
-export declare function writeAgentsMd(dirPath: string, projectRoot: string): Promise<string>;
+export declare function writeAgentsMd(dirPath: string, _projectRoot: string, content: string): Promise<string>;
 //# sourceMappingURL=agents-md.d.ts.map

package/dist/generation/writers/agents-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../../src/generation/writers/agents-md.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,oCAAoC;IACpC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,GAAE,OAAe,GAAG,MAAM,CA+DtF;AA+GD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAyEvB;AA0BD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CA0BjB"}
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../../src/generation/writers/agents-md.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CA0BjB"}