vralphy 0.8.0

package/dist/lib/prompts/opencode.js

@@ -0,0 +1,71 @@
+/**
+ * OpenCode-specific prompt templates
+ *
+ * OpenCode uses Plan/Build modes for context isolation. It doesn't support
+ * parallel tool calls or native subagents, so prompts focus on sequential
+ * focused iterations with clear mode awareness.
+ */
+/**
+ * Skills and agents lazy loading section for OpenCode
+ */
+const OPENCODE_LAZY_LOADING_SECTION = `
+## Lazy Loading
+
+Skills: \${skillsDir} - Load ONLY when stuck or task requires domain knowledge
+Agents: \${agentsDir} - Load ONLY for deep specialized analysis
+
+Do NOT preload - keep context focused on current task.
+`;
+/**
+ * OpenCode plan mode prompt
+ */
+export const OPENCODE_PLAN_PROMPT = `0a. Study .vralphy/AGENTS.md to understand how to build/test/run this project.
+0b. Study specs/* systematically to learn the project specifications.
+0c. Study @IMPLEMENTATION_PLAN.md (if present) to understand the plan so far.
+0d. Study src/lib/* to understand shared utilities & components.
+0e. For reference, the application source code is in src/*.
+
+1. Study @IMPLEMENTATION_PLAN.md (if present; it may be incorrect) and study existing source code in src/* and compare it against specs/*. Analyze findings, prioritize tasks, and create/update @IMPLEMENTATION_PLAN.md as a bullet point list sorted in priority of items yet to be implemented. Consider searching for TODO, minimal implementations, placeholders, skipped/flaky tests, and inconsistent patterns.
+
+IMPORTANT: Plan only. Do NOT implement anything. Do NOT assume functionality is missing; confirm with code search first. Treat src/lib as the project's standard library for shared utilities and components. Prefer consolidated, idiomatic implementations there over ad-hoc copies.
+
+## Mode Awareness
+
+You are in PLAN mode. Focus on analysis and prioritization. Do NOT make code changes.
+${OPENCODE_LAZY_LOADING_SECTION}`;
+/**
+ * OpenCode build mode prompt
+ */
+export const OPENCODE_BUILD_PROMPT = `0a. Study .vralphy/AGENTS.md to understand how to build/test/run this project.
+0b. Study specs/* systematically to learn the project specifications.
+0c. Study @IMPLEMENTATION_PLAN.md.
+0d. For reference, the application source code is in src/*.
+
+1. Your task is to implement functionality per the specifications. Follow @IMPLEMENTATION_PLAN.md and choose the most important item to address. Before making changes, search the codebase thoroughly (don't assume not implemented). OpenCode executes sequentially - read related files in logical groups, start with critical path files first.
+
+2. After implementing functionality or resolving problems, run the tests for that unit of code that was improved. If functionality is missing then it's your job to add it as per the application specifications.
+
+3. When you discover issues, immediately update @IMPLEMENTATION_PLAN.md with your findings. When resolved, update and remove the item.
+
+4. When the tests pass, update @IMPLEMENTATION_PLAN.md, then git add -A then git commit with a message describing the changes. After the commit, git push.
+
+## Mode Awareness
+
+You are in BUILD mode. Focus on implementation. If you need to analyze architecture or plan a major refactor, suggest switching to PLAN mode.
+
+99999. When authoring documentation, capture the why - tests and implementation importance.
+999999. Single sources of truth, no migrations/adapters. If tests unrelated to your work fail, resolve them as part of the increment.
+9999999. As soon as there are no build or test errors create a git tag. If there are no git tags start at 0.0.0 and increment patch by 1.
+99999999. You may add extra logging if required to debug issues.
+999999999. Keep @IMPLEMENTATION_PLAN.md current with learnings - future work depends on this.
+9999999999. When you learn something new about how to run the application, update .vralphy/AGENTS.md but keep it brief.
+99999999999. For any bugs you notice, resolve them or document them in @IMPLEMENTATION_PLAN.md even if unrelated to current work.
+999999999999. Implement functionality completely. Placeholders and stubs waste efforts and time redoing the same work.
+9999999999999. When @IMPLEMENTATION_PLAN.md becomes large periodically clean out the items that are completed.
+99999999999999. IMPORTANT: Keep .vralphy/AGENTS.md operational only - status updates belong in IMPLEMENTATION_PLAN.md. A bloated AGENTS.md pollutes every future loop's context.
+
+## Context Freshness
+
+Complete one task fully before starting another. Update @IMPLEMENTATION_PLAN.md frequently - it persists across sessions. If overwhelmed, focus on single most important task.
+${OPENCODE_LAZY_LOADING_SECTION}`;
+//# sourceMappingURL=opencode.js.map

package/dist/lib/prompts/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/lib/prompts/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,6BAA6B,GAAG;;;;;;;CAOrC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;EAalC,6BAA6B,EAAE,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BnC,6BAA6B,EAAE,CAAC"}

package/dist/lib/prompts.d.ts

@@ -0,0 +1,57 @@
+import { EngineName } from './engines/index.js';
+import { CODEX_DEFAULT_MAX_AGENTS, CODEX_DEFAULT_WORKER_TIMEOUT } from './prompts/codex.js';
+export interface PromptContext {
+    planningModel: string;
+    executorModel: string;
+    engine: EngineName;
+    projectName?: string;
+    existingSpecs?: string[];
+    topic?: string;
+    maxAgents?: number;
+    workerTimeout?: number;
+}
+/**
+ * Get skill/agent locations for an engine
+ */
+export declare function getEngineLocations(engine: EngineName): {
+    skills: string;
+    agents: string;
+};
+/**
+ * Load a prompt template from file
+ */
+export declare function loadPromptTemplate(path: string): Promise<string>;
+/**
+ * Interpolate variables in prompt template
+ */
+export declare function interpolatePrompt(template: string, context: PromptContext): string;
+/**
+ * Load and interpolate prompt
+ */
+export declare function loadPrompt(path: string, context: PromptContext): Promise<string>;
+/**
+ * Default plan mode prompt
+ */
+export declare const DEFAULT_PLAN_PROMPT = "0a. Study .vralphy/AGENTS.md to understand how to build/test/run this project.\n0b. Study `specs/*` with up to 250 parallel ${executor} subagents to learn the project specifications.\n0c. Study @IMPLEMENTATION_PLAN.md (if present) to understand the plan so far.\n0d. Study `src/lib/*` with up to 250 parallel ${executor} subagents to understand shared utilities & components.\n0e. For reference, the application source code is in `src/*`.\n\n1. Study @IMPLEMENTATION_PLAN.md (if present; it may be incorrect) and use up to 500 ${executor} subagents to study existing source code in `src/*` and compare it against `specs/*`. Use an ${model} subagent to analyze findings, prioritize tasks, and create/update @IMPLEMENTATION_PLAN.md as a bullet point list sorted in priority of items yet to be implemented. Ultrathink. Consider searching for TODO, minimal implementations, placeholders, skipped/flaky tests, and inconsistent patterns. Study @IMPLEMENTATION_PLAN.md to determine starting point for research and keep it up to date with items considered complete/incomplete using subagents.\n\nIMPORTANT: Plan only. Do NOT implement anything. Do NOT assume functionality is missing; confirm with code search first. Treat `src/lib` as the project's standard library for shared utilities and components. Prefer consolidated, idiomatic implementations there over ad-hoc copies.\n\n## Skills & Agents (On-Demand Loading)\n\nSkills location: ${skillsDir}\nAgents location: ${agentsDir}\n\nIMPORTANT - Context is precious. DO NOT preload all skills/agents.\n\n### When to load a skill:\n- Current task requires domain-specific knowledge you lack\n- A spec explicitly references a framework/library that has a matching skill\n- You've attempted something twice and failed - check if a skill could help\n\n### When to spawn a specialized agent:\n- Task requires deep focused expertise (security audit, architecture review)\n- You need a second opinion on a complex decision\n- Parallel work that benefits from isolation\n\n### How to load:\n1. Use a ${executor} subagent to read the skill/agent file\n2. Extract only the relevant section for your current task\n3. Do NOT inject entire skill contents into main context\n\n### Available skills (check if directory exists):\nList files in ${skillsDir} only when you need domain knowledge.\n\n### Available agents (check if directory exists):\nList files in ${agentsDir} only when you need to spawn specialized help.\n";
+/**
+ * Default build mode prompt
+ */
+export declare const DEFAULT_BUILD_PROMPT = "0a. Study .vralphy/AGENTS.md to understand how to build/test/run this project.\n0b. Study `specs/*` with up to 500 parallel ${executor} subagents to learn the project specifications.\n0c. Study @IMPLEMENTATION_PLAN.md.\n0d. For reference, the application source code is in `src/*`.\n\n1. Your task is to implement functionality per the specifications using parallel subagents. Follow @IMPLEMENTATION_PLAN.md and choose the most important item to address. Before making changes, search the codebase (don't assume not implemented) using ${executor} subagents. You may use up to 500 parallel ${executor} subagents for searches/reads and only 1 ${executor} subagent for build/tests. Use ${model} subagents when complex reasoning is needed (debugging, architectural decisions).\n\n2. After implementing functionality or resolving problems, run the tests for that unit of code that was improved. If functionality is missing then it's your job to add it as per the application specifications. Ultrathink.\n\n3. When you discover issues, immediately update @IMPLEMENTATION_PLAN.md with your findings using a subagent. When resolved, update and remove the item.\n\n4. When the tests pass, update @IMPLEMENTATION_PLAN.md, then `git add -A` then `git commit` with a message describing the changes. After the commit, `git push`.\n\n99999. When authoring documentation, capture the why \u2014 tests and implementation importance.\n999999. Single sources of truth, no migrations/adapters. If tests unrelated to your work fail, resolve them as part of the increment.\n9999999. As soon as there are no build or test errors create a git tag. If there are no git tags start at 0.0.0 and increment patch by 1.\n99999999. You may add extra logging if required to debug issues.\n999999999. Keep @IMPLEMENTATION_PLAN.md current with learnings using a subagent \u2014 future work depends on this.\n9999999999. When you learn something new about how to run the application, update .vralphy/AGENTS.md using a subagent but keep it brief.\n99999999999. For any bugs you notice, resolve them or document them in @IMPLEMENTATION_PLAN.md even if unrelated to current work.\n999999999999. Implement functionality completely. Placeholders and stubs waste efforts and time redoing the same work.\n9999999999999. When @IMPLEMENTATION_PLAN.md becomes large periodically clean out the items that are completed using a subagent.\n99999999999999. IMPORTANT: Keep .vralphy/AGENTS.md operational only \u2014 status updates belong in `IMPLEMENTATION_PLAN.md`. A bloated AGENTS.md pollutes every future loop's context.\n\n## Skills & Agents (On-Demand Loading)\n\nSkills location: ${skillsDir}\nAgents location: ${agentsDir}\n\nIMPORTANT - Context is precious. DO NOT preload all skills/agents.\n\n### When to load a skill:\n- Current task requires domain-specific knowledge you lack\n- A spec explicitly references a framework/library that has a matching skill\n- You've attempted something twice and failed - check if a skill could help\n\n### When to spawn a specialized agent:\n- Task requires deep focused expertise (security audit, architecture review)\n- You need a second opinion on a complex decision\n- Parallel work that benefits from isolation\n\n### How to load:\n1. Use a ${executor} subagent to read the skill/agent file\n2. Extract only the relevant section for your current task\n3. Do NOT inject entire skill contents into main context\n\n### Available skills (check if directory exists):\nList files in ${skillsDir} only when you need domain knowledge.\n\n### Available agents (check if directory exists):\nList files in ${agentsDir} only when you need to spawn specialized help.\n";
+/**
+ * Default init mode prompt for AI-powered AGENTS.md generation
+ */
+export declare const DEFAULT_INIT_PROMPT = "You are initializing a project for AI-assisted development. Generate a lightweight AGENTS.md file.\n\n## Project Context\n${projectContext}\n\n## Requirements\n- Maximum 60 lines total\n- OPERATIONAL ONLY: build, run, test, lint, typecheck commands\n- Include project-specific patterns discovered from existing docs\n- Focus on commands that actually exist in the project\n- NO: changelogs, TODOs, verbose explanations, generic advice\n\n## Output Sections\n\nGenerate ONLY these sections (skip if no relevant commands):\n\n## Build & Run\n- Build: `command`\n- Dev: `command`\n\n## Validation\n- Tests: `command`\n- Typecheck: `command`\n- Lint: `command`\n\n## Tech Stack\n- Brief list of main technologies\n\n## Codebase Patterns\n- Bullet points of project-specific conventions (extracted from existing docs)\n\n## IMPORTANT\nIf critical information is missing (like how to run tests), ask UP TO 3 clarifying questions first.\nOutput ONLY the AGENTS.md content, no preamble or explanation.\n";
+/**
+ * Default spec mode prompt
+ */
+export declare const DEFAULT_SPEC_PROMPT = "You are helping define requirements for: ${topic}\n\n## Context\n- Project: ${projectName}\n- Existing specs: ${existingSpecs}\n\n## Your Task\n\n1. Ask clarifying questions to understand the requirement fully\n2. Consider edge cases and constraints\n3. Draft a complete specification\n4. Present for user approval\n\n## Question Guidelines\n\nAsk about:\n- User personas and use cases\n- Happy path and error cases\n- Integration points\n- Performance requirements\n- Security considerations\n\n## Output Format\n\nWhen ready, output the spec in this format:\n\n# ${topic}\n\n## Overview\n[Brief description]\n\n## Requirements\n- [ ] Requirement 1\n- [ ] Requirement 2\n\n## Acceptance Criteria\n- [ ] Criterion 1\n- [ ] Criterion 2\n\n## Edge Cases\n[List edge cases]\n\n## Dependencies\n[List dependencies]\n\n## Skills & Agents (On-Demand Loading)\n\nSkills location: ${skillsDir}\nAgents location: ${agentsDir}\n\nIMPORTANT - Context is precious. DO NOT preload all skills/agents.\n\n### When to load a skill:\n- Current task requires domain-specific knowledge you lack\n- A spec explicitly references a framework/library that has a matching skill\n- You've attempted something twice and failed - check if a skill could help\n\n### When to spawn a specialized agent:\n- Task requires deep focused expertise (security audit, architecture review)\n- You need a second opinion on a complex decision\n- Parallel work that benefits from isolation\n\n### How to load:\n1. Use a ${executor} subagent to read the skill/agent file\n2. Extract only the relevant section for your current task\n3. Do NOT inject entire skill contents into main context\n\n### Available skills (check if directory exists):\nList files in ${skillsDir} only when you need domain knowledge.\n\n### Available agents (check if directory exists):\nList files in ${agentsDir} only when you need to spawn specialized help.\n";
+/**
+ * Get default build prompt for a specific engine
+ */
+export declare function getDefaultBuildPrompt(engine: EngineName): string;
+/**
+ * Get default plan prompt for a specific engine
+ */
+export declare function getDefaultPlanPrompt(engine: EngineName): string;
+export { CODEX_DEFAULT_MAX_AGENTS, CODEX_DEFAULT_WORKER_TIMEOUT };
+//# sourceMappingURL=prompts.d.ts.map

package/dist/lib/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/lib/prompts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAGL,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAiBzF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CA+BlF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtF;AAmCD;;GAEG;AACH,eAAO,MAAM,mBAAmB,u5EASR,CAAC;AAEzB;;GAEG;AACH,eAAO,MAAM,oBAAoB,+kHAuBT,CAAC;AAEzB;;GAEG;AACH,eAAO,MAAM,mBAAmB,w+BAkC/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,y2DA4CR,CAAC;AAEzB;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAShE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAS/D;AAGD,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/lib/prompts.js

@@ -0,0 +1,255 @@
+import { readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { CODEX_PLAN_PROMPT, CODEX_BUILD_PROMPT, CODEX_DEFAULT_MAX_AGENTS, CODEX_DEFAULT_WORKER_TIMEOUT, } from './prompts/codex.js';
+import { OPENCODE_PLAN_PROMPT, OPENCODE_BUILD_PROMPT } from './prompts/opencode.js';
+/**
+ * Get skill/agent locations for an engine
+ */
+export function getEngineLocations(engine) {
+    const locations = {
+        claude: {
+            skills: '.claude/skills/',
+            agents: '.claude/agents/',
+        },
+        opencode: {
+            skills: '.opencode/skills/',
+            agents: '.opencode/agents/',
+        },
+        codex: {
+            skills: '.codex/skills/',
+            agents: '.codex/agents/',
+        },
+    };
+    return locations[engine];
+}
+/**
+ * Load a prompt template from file
+ */
+export async function loadPromptTemplate(path) {
+    if (!existsSync(path)) {
+        throw new Error(`Prompt template not found: ${path}`);
+    }
+    return readFile(path, 'utf-8');
+}
+/**
+ * Interpolate variables in prompt template
+ */
+export function interpolatePrompt(template, context) {
+    let result = template;
+    result = result.replace(/\$\{model\}/g, context.planningModel);
+    result = result.replace(/\$\{executor\}/g, context.executorModel);
+    result = result.replace(/\$\{primary\}/g, context.planningModel);
+    result = result.replace(/\$\{engine\}/g, context.engine);
+    const locations = getEngineLocations(context.engine);
+    result = result.replace(/\$\{skillsDir\}/g, locations.skills);
+    result = result.replace(/\$\{agentsDir\}/g, locations.agents);
+    if (context.projectName) {
+        result = result.replace(/\$\{projectName\}/g, context.projectName);
+    }
+    if (context.existingSpecs) {
+        result = result.replace(/\$\{existingSpecs\}/g, context.existingSpecs.join(', ') || 'none');
+    }
+    if (context.topic) {
+        result = result.replace(/\$\{topic\}/g, context.topic);
+    }
+    // Codex-specific interpolations
+    const maxAgents = context.maxAgents ?? CODEX_DEFAULT_MAX_AGENTS;
+    const workerTimeout = context.workerTimeout ?? CODEX_DEFAULT_WORKER_TIMEOUT;
+    result = result.replace(/\$\{maxAgents\}/g, String(maxAgents));
+    result = result.replace(/\$\{workerTimeout\}/g, String(workerTimeout));
+    return result;
+}
+/**
+ * Load and interpolate prompt
+ */
+export async function loadPrompt(path, context) {
+    const template = await loadPromptTemplate(path);
+    return interpolatePrompt(template, context);
+}
+/**
+ * Skills and agents lazy loading section (appended to prompts)
+ */
+const LAZY_LOADING_SECTION = `
+## Skills & Agents (On-Demand Loading)
+
+Skills location: \${skillsDir}
+Agents location: \${agentsDir}
+
+IMPORTANT - Context is precious. DO NOT preload all skills/agents.
+
+### When to load a skill:
+- Current task requires domain-specific knowledge you lack
+- A spec explicitly references a framework/library that has a matching skill
+- You've attempted something twice and failed - check if a skill could help
+
+### When to spawn a specialized agent:
+- Task requires deep focused expertise (security audit, architecture review)
+- You need a second opinion on a complex decision
+- Parallel work that benefits from isolation
+
+### How to load:
+1. Use a \${executor} subagent to read the skill/agent file
+2. Extract only the relevant section for your current task
+3. Do NOT inject entire skill contents into main context
+
+### Available skills (check if directory exists):
+List files in \${skillsDir} only when you need domain knowledge.
+
+### Available agents (check if directory exists):
+List files in \${agentsDir} only when you need to spawn specialized help.
+`;
+/**
+ * Default plan mode prompt
+ */
+export const DEFAULT_PLAN_PROMPT = `0a. Study .vralphy/AGENTS.md to understand how to build/test/run this project.
+0b. Study \`specs/*\` with up to 250 parallel \${executor} subagents to learn the project specifications.
+0c. Study @IMPLEMENTATION_PLAN.md (if present) to understand the plan so far.
+0d. Study \`src/lib/*\` with up to 250 parallel \${executor} subagents to understand shared utilities & components.
+0e. For reference, the application source code is in \`src/*\`.
+
+1. Study @IMPLEMENTATION_PLAN.md (if present; it may be incorrect) and use up to 500 \${executor} subagents to study existing source code in \`src/*\` and compare it against \`specs/*\`. Use an \${model} subagent to analyze findings, prioritize tasks, and create/update @IMPLEMENTATION_PLAN.md as a bullet point list sorted in priority of items yet to be implemented. Ultrathink. Consider searching for TODO, minimal implementations, placeholders, skipped/flaky tests, and inconsistent patterns. Study @IMPLEMENTATION_PLAN.md to determine starting point for research and keep it up to date with items considered complete/incomplete using subagents.
+
+IMPORTANT: Plan only. Do NOT implement anything. Do NOT assume functionality is missing; confirm with code search first. Treat \`src/lib\` as the project's standard library for shared utilities and components. Prefer consolidated, idiomatic implementations there over ad-hoc copies.
+${LAZY_LOADING_SECTION}`;
+/**
+ * Default build mode prompt
+ */
+export const DEFAULT_BUILD_PROMPT = `0a. Study .vralphy/AGENTS.md to understand how to build/test/run this project.
+0b. Study \`specs/*\` with up to 500 parallel \${executor} subagents to learn the project specifications.
+0c. Study @IMPLEMENTATION_PLAN.md.
+0d. For reference, the application source code is in \`src/*\`.
+
+1. Your task is to implement functionality per the specifications using parallel subagents. Follow @IMPLEMENTATION_PLAN.md and choose the most important item to address. Before making changes, search the codebase (don't assume not implemented) using \${executor} subagents. You may use up to 500 parallel \${executor} subagents for searches/reads and only 1 \${executor} subagent for build/tests. Use \${model} subagents when complex reasoning is needed (debugging, architectural decisions).
+
+2. After implementing functionality or resolving problems, run the tests for that unit of code that was improved. If functionality is missing then it's your job to add it as per the application specifications. Ultrathink.
+
+3. When you discover issues, immediately update @IMPLEMENTATION_PLAN.md with your findings using a subagent. When resolved, update and remove the item.
+
+4. When the tests pass, update @IMPLEMENTATION_PLAN.md, then \`git add -A\` then \`git commit\` with a message describing the changes. After the commit, \`git push\`.
+
+99999. When authoring documentation, capture the why — tests and implementation importance.
+999999. Single sources of truth, no migrations/adapters. If tests unrelated to your work fail, resolve them as part of the increment.
+9999999. As soon as there are no build or test errors create a git tag. If there are no git tags start at 0.0.0 and increment patch by 1.
+99999999. You may add extra logging if required to debug issues.
+999999999. Keep @IMPLEMENTATION_PLAN.md current with learnings using a subagent — future work depends on this.
+9999999999. When you learn something new about how to run the application, update .vralphy/AGENTS.md using a subagent but keep it brief.
+99999999999. For any bugs you notice, resolve them or document them in @IMPLEMENTATION_PLAN.md even if unrelated to current work.
+999999999999. Implement functionality completely. Placeholders and stubs waste efforts and time redoing the same work.
+9999999999999. When @IMPLEMENTATION_PLAN.md becomes large periodically clean out the items that are completed using a subagent.
+99999999999999. IMPORTANT: Keep .vralphy/AGENTS.md operational only — status updates belong in \`IMPLEMENTATION_PLAN.md\`. A bloated AGENTS.md pollutes every future loop's context.
+${LAZY_LOADING_SECTION}`;
+/**
+ * Default init mode prompt for AI-powered AGENTS.md generation
+ */
+export const DEFAULT_INIT_PROMPT = `You are initializing a project for AI-assisted development. Generate a lightweight AGENTS.md file.
+
+## Project Context
+\${projectContext}
+
+## Requirements
+- Maximum 60 lines total
+- OPERATIONAL ONLY: build, run, test, lint, typecheck commands
+- Include project-specific patterns discovered from existing docs
+- Focus on commands that actually exist in the project
+- NO: changelogs, TODOs, verbose explanations, generic advice
+
+## Output Sections
+
+Generate ONLY these sections (skip if no relevant commands):
+
+## Build & Run
+- Build: \`command\`
+- Dev: \`command\`
+
+## Validation
+- Tests: \`command\`
+- Typecheck: \`command\`
+- Lint: \`command\`
+
+## Tech Stack
+- Brief list of main technologies
+
+## Codebase Patterns
+- Bullet points of project-specific conventions (extracted from existing docs)
+
+## IMPORTANT
+If critical information is missing (like how to run tests), ask UP TO 3 clarifying questions first.
+Output ONLY the AGENTS.md content, no preamble or explanation.
+`;
+/**
+ * Default spec mode prompt
+ */
+export const DEFAULT_SPEC_PROMPT = `You are helping define requirements for: \${topic}
+
+## Context
+- Project: \${projectName}
+- Existing specs: \${existingSpecs}
+
+## Your Task
+
+1. Ask clarifying questions to understand the requirement fully
+2. Consider edge cases and constraints
+3. Draft a complete specification
+4. Present for user approval
+
+## Question Guidelines
+
+Ask about:
+- User personas and use cases
+- Happy path and error cases
+- Integration points
+- Performance requirements
+- Security considerations
+
+## Output Format
+
+When ready, output the spec in this format:
+
+# \${topic}
+
+## Overview
+[Brief description]
+
+## Requirements
+- [ ] Requirement 1
+- [ ] Requirement 2
+
+## Acceptance Criteria
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+## Edge Cases
+[List edge cases]
+
+## Dependencies
+[List dependencies]
+${LAZY_LOADING_SECTION}`;
+/**
+ * Get default build prompt for a specific engine
+ */
+export function getDefaultBuildPrompt(engine) {
+    switch (engine) {
+        case 'codex':
+            return CODEX_BUILD_PROMPT;
+        case 'opencode':
+            return OPENCODE_BUILD_PROMPT;
+        default:
+            return DEFAULT_BUILD_PROMPT;
+    }
+}
+/**
+ * Get default plan prompt for a specific engine
+ */
+export function getDefaultPlanPrompt(engine) {
+    switch (engine) {
+        case 'codex':
+            return CODEX_PLAN_PROMPT;
+        case 'opencode':
+            return OPENCODE_PLAN_PROMPT;
+        default:
+            return DEFAULT_PLAN_PROMPT;
+    }
+}
+// Re-export Codex constants for external use
+export { CODEX_DEFAULT_MAX_AGENTS, CODEX_DEFAULT_WORKER_TIMEOUT };
+//# sourceMappingURL=prompts.js.map

package/dist/lib/prompts.js.map

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

package/dist/lib/prompts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompts.test.d.ts.map

package/dist/lib/prompts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.test.d.ts","sourceRoot":"","sources":["../../src/lib/prompts.test.ts"],"names":[],"mappings":""}

package/dist/lib/prompts.test.js

@@ -0,0 +1,128 @@
+import { describe, it, expect } from 'vitest';
+import { getDefaultBuildPrompt, getDefaultPlanPrompt, getEngineLocations, interpolatePrompt, } from './prompts.js';
+import { CODEX_BUILD_PROMPT, CODEX_PLAN_PROMPT } from './prompts/codex.js';
+import { OPENCODE_BUILD_PROMPT, OPENCODE_PLAN_PROMPT } from './prompts/opencode.js';
+describe('getDefaultBuildPrompt', () => {
+    it('returns Codex-specific prompt for codex engine', () => {
+        const prompt = getDefaultBuildPrompt('codex');
+        expect(prompt).toBe(CODEX_BUILD_PROMPT);
+    });
+    it('returns OpenCode-specific prompt for opencode engine', () => {
+        const prompt = getDefaultBuildPrompt('opencode');
+        expect(prompt).toBe(OPENCODE_BUILD_PROMPT);
+    });
+    it('returns default prompt for claude engine', () => {
+        const prompt = getDefaultBuildPrompt('claude');
+        expect(prompt).not.toBe(CODEX_BUILD_PROMPT);
+        expect(prompt).not.toBe(OPENCODE_BUILD_PROMPT);
+        expect(prompt).toContain('subagent'); // Claude supports subagents
+    });
+});
+describe('getDefaultPlanPrompt', () => {
+    it('returns Codex-specific prompt for codex engine', () => {
+        const prompt = getDefaultPlanPrompt('codex');
+        expect(prompt).toBe(CODEX_PLAN_PROMPT);
+    });
+    it('returns OpenCode-specific prompt for opencode engine', () => {
+        const prompt = getDefaultPlanPrompt('opencode');
+        expect(prompt).toBe(OPENCODE_PLAN_PROMPT);
+    });
+    it('returns default prompt for claude engine', () => {
+        const prompt = getDefaultPlanPrompt('claude');
+        expect(prompt).not.toBe(CODEX_PLAN_PROMPT);
+        expect(prompt).not.toBe(OPENCODE_PLAN_PROMPT);
+        expect(prompt).toContain('subagent'); // Claude supports subagents
+    });
+});
+describe('getEngineLocations', () => {
+    it('returns claude-specific locations', () => {
+        const locations = getEngineLocations('claude');
+        expect(locations.skills).toBe('.claude/skills/');
+        expect(locations.agents).toBe('.claude/agents/');
+    });
+    it('returns opencode-specific locations', () => {
+        const locations = getEngineLocations('opencode');
+        expect(locations.skills).toBe('.opencode/skills/');
+        expect(locations.agents).toBe('.opencode/agents/');
+    });
+    it('returns codex-specific locations', () => {
+        const locations = getEngineLocations('codex');
+        expect(locations.skills).toBe('.codex/skills/');
+        expect(locations.agents).toBe('.codex/agents/');
+    });
+});
+describe('interpolatePrompt', () => {
+    it('interpolates model names correctly', () => {
+        const template = 'Model: ${model}, Executor: ${executor}';
+        const result = interpolatePrompt(template, {
+            planningModel: 'opus',
+            executorModel: 'sonnet',
+            engine: 'claude',
+        });
+        expect(result).toBe('Model: opus, Executor: sonnet');
+    });
+    it('interpolates engine-specific directories', () => {
+        const template = 'Skills: ${skillsDir}, Agents: ${agentsDir}';
+        const result = interpolatePrompt(template, {
+            planningModel: 'opus',
+            executorModel: 'sonnet',
+            engine: 'codex',
+        });
+        expect(result).toContain('.codex/skills/');
+        expect(result).toContain('.codex/agents/');
+    });
+    it('interpolates optional project context', () => {
+        const template = 'Project: ${projectName}, Topic: ${topic}';
+        const result = interpolatePrompt(template, {
+            planningModel: 'opus',
+            executorModel: 'sonnet',
+            engine: 'claude',
+            projectName: 'test-project',
+            topic: 'authentication',
+        });
+        expect(result).toBe('Project: test-project, Topic: authentication');
+    });
+});
+describe('Codex prompts (no subagent references)', () => {
+    it('CODEX_BUILD_PROMPT does not reference spawn_agent', () => {
+        expect(CODEX_BUILD_PROMPT).not.toContain('spawn_agent');
+        expect(CODEX_BUILD_PROMPT).not.toContain('wait');
+        expect(CODEX_BUILD_PROMPT).not.toContain('close_agent');
+    });
+    it('CODEX_BUILD_PROMPT contains multi_tool_use.parallel', () => {
+        expect(CODEX_BUILD_PROMPT).toContain('multi_tool_use.parallel');
+    });
+    it('CODEX_BUILD_PROMPT contains /compact instruction', () => {
+        expect(CODEX_BUILD_PROMPT).toContain('/compact');
+    });
+    it('CODEX_PLAN_PROMPT does not reference spawn_agent', () => {
+        expect(CODEX_PLAN_PROMPT).not.toContain('spawn_agent');
+        expect(CODEX_PLAN_PROMPT).not.toContain('wait');
+        expect(CODEX_PLAN_PROMPT).not.toContain('close_agent');
+    });
+    it('CODEX_PLAN_PROMPT contains multi_tool_use.parallel', () => {
+        expect(CODEX_PLAN_PROMPT).toContain('multi_tool_use.parallel');
+    });
+});
+describe('OpenCode prompts (mode awareness)', () => {
+    it('OPENCODE_BUILD_PROMPT contains mode awareness', () => {
+        expect(OPENCODE_BUILD_PROMPT).toContain('Mode Awareness');
+        expect(OPENCODE_BUILD_PROMPT).toContain('BUILD mode');
+    });
+    it('OPENCODE_BUILD_PROMPT does not reference subagents', () => {
+        expect(OPENCODE_BUILD_PROMPT).not.toContain('subagent');
+        expect(OPENCODE_BUILD_PROMPT).not.toContain('spawn_agent');
+    });
+    it('OPENCODE_BUILD_PROMPT uses sequential execution language', () => {
+        expect(OPENCODE_BUILD_PROMPT).toContain('systematically');
+    });
+    it('OPENCODE_PLAN_PROMPT contains mode awareness', () => {
+        expect(OPENCODE_PLAN_PROMPT).toContain('Mode Awareness');
+        expect(OPENCODE_PLAN_PROMPT).toContain('PLAN mode');
+    });
+    it('OPENCODE_PLAN_PROMPT does not reference subagents', () => {
+        expect(OPENCODE_PLAN_PROMPT).not.toContain('subagent');
+        expect(OPENCODE_PLAN_PROMPT).not.toContain('spawn_agent');
+    });
+});
+//# sourceMappingURL=prompts.test.js.map

package/dist/lib/prompts.test.js.map

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

package/dist/lib/skills.d.ts

@@ -0,0 +1,36 @@
+export interface SkillMetadata {
+    name: string;
+    description?: string;
+    triggers?: string[];
+    alwaysInclude?: boolean;
+}
+export interface Skill {
+    name: string;
+    path: string;
+    metadata: SkillMetadata;
+    content: string;
+}
+/**
+ * Load all skills from a directory
+ */
+export declare function loadSkills(dir: string): Promise<Skill[]>;
+/**
+ * Filter skills by triggers matching text
+ */
+export declare function filterSkillsByTriggers(skills: Skill[], text: string): Skill[];
+/**
+ * Format skills for prompt injection
+ */
+export declare function formatSkillsForPrompt(skills: Skill[]): string;
+/**
+ * List available skills (for CLI command)
+ */
+export declare function listSkills(dir: string): Promise<{
+    name: string;
+    description?: string;
+}[]>;
+/**
+ * Get skill by name
+ */
+export declare function getSkill(dir: string, name: string): Promise<Skill | undefined>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/lib/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAmED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAoB9D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAW7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAkB7D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAG/F;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAGpF"}