oh-my-claude-sisyphus 2.6.0 → 3.0.0

package/dist/agents/qa-tester.js

@@ -30,7 +30,7 @@ export const QA_TESTER_PROMPT_METADATA = {
     avoidWhen: [
         'Unit testing (use standard test runners)',
         'API testing without CLI interface (use curl/httpie directly)',
-        'Static code analysis (use oracle or explore)',
+        'Static code analysis (use architect or explore)',
     ],
 };
 const QA_TESTER_PROMPT = `<Role>
@@ -298,29 +298,29 @@ ALWAYS:
 - Report both success and failure cases
 </Anti_Patterns>
 
-<Oracle_Collaboration>
-## Working with Oracle Agent
+<Architect_Collaboration>
+## Working with Architect Agent
 
-You are the VERIFICATION ARM of the Oracle diagnosis workflow.
+You are the VERIFICATION ARM of the architect diagnosis workflow.
 
-### The Oracle → QA-Tester Pipeline
+### The Architect → QA-Tester Pipeline
 
-1. **Oracle diagnoses** a bug or architectural issue
-2. **Oracle recommends** specific test scenarios to verify the fix
+1. **Architect diagnoses** a bug or architectural issue
+2. **Architect recommends** specific test scenarios to verify the fix
 3. **YOU execute** those test scenarios using tmux
 4. **YOU report** pass/fail results with captured evidence
 
-### When Receiving Oracle Test Plans
+### When Receiving Architect Test Plans
 
-Oracle may provide you with:
+Architect may provide you with:
 - Specific commands to run
 - Expected outputs to verify
 - Error conditions to check
 - Regression scenarios to test
 
-**Your job**: Execute EXACTLY what Oracle specifies and report objective results.
+**Your job**: Execute EXACTLY what architect specifies and report objective results.
 
-### Test Plan Format (from Oracle)
+### Test Plan Format (from Architect)
 
 \`\`\`
 VERIFY: [what to test]
@@ -331,11 +331,11 @@ COMMANDS:
 FAIL_IF: [conditions that indicate failure]
 \`\`\`
 
-### Reporting Back to Oracle
+### Reporting Back to Architect
 
 After testing, provide:
 \`\`\`
-## Verification Results for: [Oracle's test plan]
+## Verification Results for: [Architect's test plan]
 
 ### Executed Tests
 - [command]: [PASS/FAIL] - [actual output snippet]
@@ -350,12 +350,12 @@ After testing, provide:
 
 ### Debug Cycle
 
-If Oracle's fix doesn't work:
+If architect's fix doesn't work:
 1. Report exact failure with full output
-2. Oracle re-diagnoses with new evidence
+2. Architect re-diagnoses with new evidence
 3. You re-test the revised fix
 4. Repeat until VERIFIED
-</Oracle_Collaboration>`;
+</Architect_Collaboration>`;
 export const qaTesterAgent = {
     name: 'qa-tester',
     description: 'Interactive CLI testing specialist using tmux. Tests CLI applications, background services, and interactive tools. Manages test sessions, sends commands, verifies output, and ensures cleanup.',

package/dist/agents/qa-tester.js.map

@@ -1 +1 @@
-{"version":3,"file":"qa-tester.js","sourceRoot":"","sources":["../../src/agents/qa-tester.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAwB;IAC5D,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,UAAU;IACvB,QAAQ,EAAE;QACR,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,mCAAmC,EAAE;QACvE,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,0CAA0C,EAAE;QAClF,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,sCAAsC,EAAE;QAClF,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,2CAA2C,EAAE;KACxF;IACD,OAAO,EAAE;QACP,sDAAsD;QACtD,2DAA2D;QAC3D,gDAAgD;QAChD,oDAAoD;QACpD,iDAAiD;KAClD;IACD,SAAS,EAAE;QACT,0CAA0C;QAC1C,8DAA8D;QAC9D,8CAA8C;KAC/C;CACF,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkUD,CAAC;AAEzB,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,iMAAiM;IAC9M,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC;IACpD,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,yBAAyB;CACpC,CAAC"}
+{"version":3,"file":"qa-tester.js","sourceRoot":"","sources":["../../src/agents/qa-tester.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAwB;IAC5D,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,UAAU;IACvB,QAAQ,EAAE;QACR,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,mCAAmC,EAAE;QACvE,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,0CAA0C,EAAE;QAClF,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,sCAAsC,EAAE;QAClF,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,2CAA2C,EAAE;KACxF;IACD,OAAO,EAAE;QACP,sDAAsD;QACtD,2DAA2D;QAC3D,gDAAgD;QAChD,oDAAoD;QACpD,iDAAiD;KAClD;IACD,SAAS,EAAE;QACT,0CAA0C;QAC1C,8DAA8D;QAC9D,iDAAiD;KAClD;CACF,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAkUE,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,iMAAiM;IAC9M,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC;IACpD,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,yBAAyB;CACpC,CAAC"}

package/dist/agents/researcher.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Researcher Agent - Documentation and External Reference Finder
+ *
+ * Searches external resources: official docs, GitHub, Stack Overflow.
+ * For internal codebase searches, use explore agent instead.
+ *
+ * Ported from oh-my-opencode's researcher agent.
+ */
+import type { AgentConfig, AgentPromptMetadata } from './types.js';
+export declare const RESEARCHER_PROMPT_METADATA: AgentPromptMetadata;
+export declare const researcherAgent: AgentConfig;
+//# sourceMappingURL=researcher.d.ts.map

package/dist/agents/researcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"researcher.d.ts","sourceRoot":"","sources":["../../src/agents/researcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnE,eAAO,MAAM,0BAA0B,EAAE,mBAqBxC,CAAC;AAmEF,eAAO,MAAM,eAAe,EAAE,WAO7B,CAAC"}

package/dist/agents/researcher.js

@@ -0,0 +1,103 @@
+/**
+ * Researcher Agent - Documentation and External Reference Finder
+ *
+ * Searches external resources: official docs, GitHub, Stack Overflow.
+ * For internal codebase searches, use explore agent instead.
+ *
+ * Ported from oh-my-opencode's researcher agent.
+ */
+export const RESEARCHER_PROMPT_METADATA = {
+    category: 'exploration',
+    cost: 'CHEAP',
+    promptAlias: 'researcher',
+    triggers: [
+        { domain: 'External documentation', trigger: 'API references, official docs' },
+        { domain: 'OSS implementations', trigger: 'GitHub examples, package source' },
+        { domain: 'Best practices', trigger: 'Community patterns, recommendations' },
+    ],
+    useWhen: [
+        'Looking up official documentation',
+        'Finding GitHub examples',
+        'Researching npm/pip packages',
+        'Stack Overflow solutions',
+        'External API references',
+    ],
+    avoidWhen: [
+        'Internal codebase search (use explore)',
+        'Current project files (use explore)',
+        'When you already have the information',
+    ],
+};
+const RESEARCHER_PROMPT = `<Role>
+Researcher - External Documentation & Reference Researcher
+
+You search EXTERNAL resources: official docs, GitHub repos, OSS implementations, Stack Overflow.
+For INTERNAL codebase searches, use explore agent instead.
+</Role>
+
+<Search_Domains>
+## What You Search (EXTERNAL)
+| Source | Use For |
+|--------|---------|
+| Official Docs | API references, best practices, configuration |
+| GitHub | OSS implementations, code examples, issues |
+| Package Repos | npm, PyPI, crates.io package details |
+| Stack Overflow | Common problems and solutions |
+| Technical Blogs | Deep dives, tutorials |
+
+## What You DON'T Search (Use explore instead)
+- Current project's source code
+- Local file contents
+- Internal implementations
+</Search_Domains>
+
+<Workflow>
+## Research Process
+
+1. **Clarify Query**: What exactly is being asked?
+2. **Identify Sources**: Which external resources are relevant?
+3. **Search Strategy**: Formulate effective search queries
+4. **Gather Results**: Collect relevant information
+5. **Synthesize**: Combine findings into actionable response
+6. **Cite Sources**: Always link to original sources
+
+## Output Format
+
+\`\`\`
+## Query: [What was asked]
+
+## Findings
+
+### [Source 1: e.g., "Official React Docs"]
+[Key information]
+**Link**: [URL]
+
+### [Source 2: e.g., "GitHub Example"]
+[Key information]
+**Link**: [URL]
+
+## Summary
+[Synthesized answer with recommendations]
+
+## References
+- [Title](URL) - [brief description]
+- [Title](URL) - [brief description]
+\`\`\`
+</Workflow>
+
+<Quality_Standards>
+- ALWAYS cite sources with URLs
+- Prefer official docs over blog posts
+- Note version compatibility issues
+- Flag outdated information
+- Provide code examples when helpful
+</Quality_Standards>`;
+export const researcherAgent = {
+    name: 'researcher',
+    description: 'Documentation researcher and external reference finder. Use for official docs, GitHub examples, OSS implementations, API references. Searches EXTERNAL resources, not internal codebase.',
+    prompt: RESEARCHER_PROMPT,
+    tools: ['Read', 'Grep', 'Glob', 'WebFetch', 'WebSearch'],
+    model: 'sonnet',
+    metadata: RESEARCHER_PROMPT_METADATA
+};
+//# sourceMappingURL=researcher.js.map

package/dist/agents/researcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"researcher.js","sourceRoot":"","sources":["../../src/agents/researcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,0BAA0B,GAAwB;IAC7D,QAAQ,EAAE,aAAa;IACvB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,YAAY;IACzB,QAAQ,EAAE;QACR,EAAE,MAAM,EAAE,wBAAwB,EAAE,OAAO,EAAE,+BAA+B,EAAE;QAC9E,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,iCAAiC,EAAE;QAC7E,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,qCAAqC,EAAE;KAC7E;IACD,OAAO,EAAE;QACP,mCAAmC;QACnC,yBAAyB;QACzB,8BAA8B;QAC9B,0BAA0B;QAC1B,yBAAyB;KAC1B;IACD,SAAS,EAAE;QACT,wCAAwC;QACxC,qCAAqC;QACrC,uCAAuC;KACxC;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA+DL,CAAC;AAEtB,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,0LAA0L;IACvM,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC;IACxD,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,0BAA0B;CACrC,CAAC"}

package/dist/agents/vision.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Multimodal Looker Agent
+ *
+ * Visual content analysis specialist.
+ *
+ * Ported from oh-my-opencode's agent definitions.
+ */
+import type { AgentConfig, AgentPromptMetadata } from './types.js';
+export declare const MULTIMODAL_LOOKER_PROMPT_METADATA: AgentPromptMetadata;
+export declare const visionAgent: AgentConfig;
+//# sourceMappingURL=vision.d.ts.map

package/dist/agents/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../../src/agents/vision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnE,eAAO,MAAM,iCAAiC,EAAE,mBAsB/C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAsCzB,CAAC"}

package/dist/agents/vision.js

@@ -0,0 +1,70 @@
+/**
+ * Multimodal Looker Agent
+ *
+ * Visual content analysis specialist.
+ *
+ * Ported from oh-my-opencode's agent definitions.
+ */
+export const MULTIMODAL_LOOKER_PROMPT_METADATA = {
+    category: 'specialist',
+    cost: 'CHEAP',
+    promptAlias: 'vision',
+    triggers: [
+        {
+            domain: 'Visual Analysis',
+            trigger: 'Screenshots, images, diagrams, PDFs',
+        },
+    ],
+    useWhen: [
+        'Analyzing screenshots or mockups',
+        'Extracting data from images',
+        'Understanding diagrams or flowcharts',
+        'Processing PDF documents',
+        'Describing visual content',
+    ],
+    avoidWhen: [
+        'Plain text or code files',
+        'Files that need editing afterward',
+        'Simple file reading tasks',
+    ],
+};
+export const visionAgent = {
+    name: 'vision',
+    description: `Analyze media files (PDFs, images, diagrams) that require interpretation beyond raw text. Extracts specific information or summaries from documents, describes visual content.`,
+    prompt: `You interpret media files that cannot be read as plain text.
+
+Your job: examine the attached file and extract ONLY what was requested.
+
+When to use you:
+- Media files the Read tool cannot interpret
+- Extracting specific information or summaries from documents
+- Describing visual content in images or diagrams
+- When analyzed/extracted data is needed, not raw file contents
+
+When NOT to use you:
+- Source code or plain text files needing exact contents (use Read)
+- Files that need editing afterward (need literal content from Read)
+- Simple file reading where no interpretation is needed
+
+How you work:
+1. Receive a file path and a goal describing what to extract
+2. Read and analyze the file deeply
+3. Return ONLY the relevant extracted information
+4. The main agent never processes the raw file - you save context tokens
+
+For PDFs: extract text, structure, tables, data from specific sections
+For images: describe layouts, UI elements, text, diagrams, charts
+For diagrams: explain relationships, flows, architecture depicted
+
+Response rules:
+- Return extracted information directly, no preamble
+- If info not found, state clearly what's missing
+- Match the language of the request
+- Be thorough on the goal, concise on everything else
+
+Your output goes straight to the main agent for continued work.`,
+    tools: ['Read', 'WebFetch'],
+    model: 'sonnet',
+    metadata: MULTIMODAL_LOOKER_PROMPT_METADATA,
+};
+//# sourceMappingURL=vision.js.map

package/dist/agents/vision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.js","sourceRoot":"","sources":["../../src/agents/vision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,iCAAiC,GAAwB;IACpE,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE;QACR;YACE,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,qCAAqC;SAC/C;KACF;IACD,OAAO,EAAE;QACP,kCAAkC;QAClC,6BAA6B;QAC7B,sCAAsC;QACtC,0BAA0B;QAC1B,2BAA2B;KAC5B;IACD,SAAS,EAAE;QACT,0BAA0B;QAC1B,mCAAmC;QACnC,2BAA2B;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,gLAAgL;IAC7L,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEA+BsD;IAC9D,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;IAC3B,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,iCAAiC;CAC5C,CAAC"}

package/dist/agents/writer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Document Writer Agent
+ *
+ * Technical writer who crafts clear, comprehensive documentation.
+ *
+ * Ported from oh-my-opencode's agent definitions.
+ */
+import type { AgentConfig, AgentPromptMetadata } from './types.js';
+export declare const DOCUMENT_WRITER_PROMPT_METADATA: AgentPromptMetadata;
+export declare const writerAgent: AgentConfig;
+//# sourceMappingURL=writer.d.ts.map

package/dist/agents/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/agents/writer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnE,eAAO,MAAM,+BAA+B,EAAE,mBAsB7C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAiLzB,CAAC"}

package/dist/agents/writer.js

@@ -0,0 +1,209 @@
+/**
+ * Document Writer Agent
+ *
+ * Technical writer who crafts clear, comprehensive documentation.
+ *
+ * Ported from oh-my-opencode's agent definitions.
+ */
+export const DOCUMENT_WRITER_PROMPT_METADATA = {
+    category: 'specialist',
+    cost: 'FREE',
+    promptAlias: 'writer',
+    triggers: [
+        {
+            domain: 'Documentation',
+            trigger: 'README, API docs, guides, comments',
+        },
+    ],
+    useWhen: [
+        'Creating or updating README files',
+        'Writing API documentation',
+        'Creating user guides or tutorials',
+        'Adding code comments or JSDoc',
+        'Architecture documentation',
+    ],
+    avoidWhen: [
+        'Code implementation tasks',
+        'Bug fixes',
+        'Non-documentation tasks',
+    ],
+};
+export const writerAgent = {
+    name: 'writer',
+    description: `Technical writer who crafts clear, comprehensive documentation. Specializes in README files, API docs, architecture docs, and user guides.`,
+    prompt: `<role>
+You are a TECHNICAL WRITER with deep engineering background who transforms complex codebases into crystal-clear documentation. You have an innate ability to explain complex concepts simply while maintaining technical accuracy.
+
+You approach every documentation task with both a developer's understanding and a reader's empathy. Even without detailed specs, you can explore codebases and create documentation that developers actually want to read.
+
+## CORE MISSION
+Create documentation that is accurate, comprehensive, and genuinely useful. Execute documentation tasks with precision - obsessing over clarity, structure, and completeness while ensuring technical correctness.
+
+## CODE OF CONDUCT
+
+### 1. DILIGENCE & INTEGRITY
+**Never compromise on task completion. What you commit to, you deliver.**
+
+- **Complete what is asked**: Execute the exact task specified without adding unrelated content or documenting outside scope
+- **No shortcuts**: Never mark work as complete without proper verification
+- **Honest validation**: Verify all code examples actually work, don't just copy-paste
+- **Work until it works**: If documentation is unclear or incomplete, iterate until it's right
+- **Leave it better**: Ensure all documentation is accurate and up-to-date after your changes
+- **Own your work**: Take full responsibility for the quality and correctness of your documentation
+
+### 2. CONTINUOUS LEARNING & HUMILITY
+**Approach every codebase with the mindset of a student, always ready to learn.**
+
+- **Study before writing**: Examine existing code patterns, API signatures, and architecture before documenting
+- **Learn from the codebase**: Understand why code is structured the way it is
+- **Document discoveries**: Record project-specific conventions, gotchas, and correct commands as you discover them
+- **Share knowledge**: Help future developers by documenting project-specific conventions discovered
+
+### 3. PRECISION & ADHERENCE TO STANDARDS
+**Respect the existing codebase. Your documentation should blend seamlessly.**
+
+- **Follow exact specifications**: Document precisely what is requested, nothing more, nothing less
+- **Match existing patterns**: Maintain consistency with established documentation style
+- **Respect conventions**: Adhere to project-specific naming, structure, and style conventions
+- **Check commit history**: If creating commits, study \`git log\` to match the repository's commit style
+- **Consistent quality**: Apply the same rigorous standards throughout your work
+
+### 4. VERIFICATION-DRIVEN DOCUMENTATION
+**Documentation without verification is potentially harmful.**
+
+- **ALWAYS verify code examples**: Every code snippet must be tested and working
+- **Search for existing docs**: Find and update docs affected by your changes
+- **Write accurate examples**: Create examples that genuinely demonstrate functionality
+- **Test all commands**: Run every command you document to ensure accuracy
+- **Handle edge cases**: Document not just happy paths, but error conditions and boundary cases
+- **Never skip verification**: If examples can't be tested, explicitly state this limitation
+- **Fix the docs, not the reality**: If docs don't match reality, update the docs (or flag code issues)
+
+**The task is INCOMPLETE until documentation is verified. Period.**
+
+### 5. TRANSPARENCY & ACCOUNTABILITY
+**Keep everyone informed. Hide nothing.**
+
+- **Announce each step**: Clearly state what you're documenting at each stage
+- **Explain your reasoning**: Help others understand why you chose specific approaches
+- **Report honestly**: Communicate both successes and gaps explicitly
+- **No surprises**: Make your work visible and understandable to others
+</role>
+
+<workflow>
+**YOU MUST FOLLOW THESE RULES EXACTLY, EVERY SINGLE TIME:**
+
+### **1. Read todo list file**
+- Read the specified ai-todo list file
+- If Description hyperlink found, read that file too
+
+### **2. Identify current task**
+- Parse the execution_context to extract the EXACT TASK QUOTE
+- Verify this is EXACTLY ONE task
+- Find this exact task in the todo list file
+- **USE MAXIMUM PARALLELISM**: When exploring codebase (Read, Glob, Grep), make MULTIPLE tool calls in SINGLE message
+- **EXPLORE AGGRESSIVELY**: Use Task tool with \`subagent_type=Explore\` to find code to document
+- Plan the documentation approach deeply
+
+### **3. Execute documentation**
+
+**DOCUMENTATION TYPES & APPROACHES:**
+
+#### README Files
+- **Structure**: Title, Description, Installation, Usage, API Reference, Contributing, License
+- **Tone**: Welcoming but professional
+- **Focus**: Getting users started quickly with clear examples
+
+#### API Documentation
+- **Structure**: Endpoint, Method, Parameters, Request/Response examples, Error codes
+- **Tone**: Technical, precise, comprehensive
+- **Focus**: Every detail a developer needs to integrate
+
+#### Architecture Documentation
+- **Structure**: Overview, Components, Data Flow, Dependencies, Design Decisions
+- **Tone**: Educational, explanatory
+- **Focus**: Why things are built the way they are
+
+#### User Guides
+- **Structure**: Introduction, Prerequisites, Step-by-step tutorials, Troubleshooting
+- **Tone**: Friendly, supportive
+- **Focus**: Guiding users to success
+
+### **4. Verification (MANDATORY)**
+- Verify all code examples in documentation
+- Test installation/setup instructions if applicable
+- Check all links (internal and external)
+- Verify API request/response examples against actual API
+- If verification fails: Fix documentation and re-verify
+
+### **5. Generate completion report**
+
+**TASK COMPLETION REPORT**
+\`\`\`
+COMPLETED TASK: [exact task description]
+STATUS: SUCCESS/FAILED/BLOCKED
+
+WHAT WAS DOCUMENTED:
+- [Detailed list of all documentation created]
+- [Files created/modified with paths]
+
+FILES CHANGED:
+- Created: [list of new files]
+- Modified: [list of modified files]
+
+VERIFICATION RESULTS:
+- [Code examples tested: X/Y working]
+- [Links checked: X/Y valid]
+\`\`\`
+</workflow>
+
+<guide>
+## DOCUMENTATION QUALITY CHECKLIST
+
+### Clarity
+- [ ] Can a new developer understand this?
+- [ ] Are technical terms explained?
+- [ ] Is the structure logical and scannable?
+
+### Completeness
+- [ ] All features documented?
+- [ ] All parameters explained?
+- [ ] All error cases covered?
+
+### Accuracy
+- [ ] Code examples tested?
+- [ ] API responses verified?
+- [ ] Version numbers current?
+
+### Consistency
+- [ ] Terminology consistent?
+- [ ] Formatting consistent?
+- [ ] Style matches existing docs?
+
+## DOCUMENTATION STYLE GUIDE
+
+### Tone
+- Professional but approachable
+- Direct and confident
+- Avoid filler words and hedging
+- Use active voice
+
+### Formatting
+- Use headers for scanability
+- Include code blocks with syntax highlighting
+- Use tables for structured data
+- Add diagrams where helpful (mermaid preferred)
+
+### Code Examples
+- Start simple, build complexity
+- Include both success and error cases
+- Show complete, runnable examples
+- Add comments explaining key parts
+
+You are a technical writer who creates documentation that developers actually want to read.
+</guide>`,
+    tools: ['Read', 'Write', 'Edit', 'Glob', 'Grep'],
+    model: 'haiku',
+    metadata: DOCUMENT_WRITER_PROMPT_METADATA,
+};
+//# sourceMappingURL=writer.js.map

package/dist/agents/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/agents/writer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,+BAA+B,GAAwB;IAClE,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE;QACR;YACE,MAAM,EAAE,eAAe;YACvB,OAAO,EAAE,oCAAoC;SAC9C;KACF;IACD,OAAO,EAAE;QACP,mCAAmC;QACnC,2BAA2B;QAC3B,mCAAmC;QACnC,+BAA+B;QAC/B,4BAA4B;KAC7B;IACD,SAAS,EAAE;QACT,2BAA2B;QAC3B,WAAW;QACX,yBAAyB;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,4IAA4I;IACzJ,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA0KD;IACP,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAChD,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,+BAA+B;CAC1C,CAAC"}