aiwcli 0.12.6 → 0.12.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (163) hide show
  1. package/bin/dev.cmd +3 -3
  2. package/bin/dev.js +16 -16
  3. package/bin/run.cmd +3 -3
  4. package/bin/run.js +21 -21
  5. package/dist/commands/branch.js +7 -2
  6. package/dist/lib/bmad-installer.js +37 -37
  7. package/dist/lib/terminal.d.ts +2 -0
  8. package/dist/lib/terminal.js +57 -7
  9. package/dist/templates/CLAUDE.md +232 -205
  10. package/dist/templates/_shared/.claude/settings.json +65 -65
  11. package/dist/templates/_shared/.claude/{commands/handoff.md → skills/handoff/SKILL.md} +13 -12
  12. package/dist/templates/_shared/.claude/{commands/handoff-resume.md → skills/handoff-resume/SKILL.md} +13 -12
  13. package/dist/templates/_shared/.codex/workflows/handoff.md +226 -226
  14. package/dist/templates/_shared/.windsurf/workflows/handoff.md +226 -226
  15. package/dist/templates/_shared/handoff-system/CLAUDE.md +15 -3
  16. package/dist/templates/_shared/handoff-system/lib/document-generator.ts +215 -215
  17. package/dist/templates/_shared/handoff-system/lib/handoff-reader.ts +158 -158
  18. package/dist/templates/_shared/handoff-system/scripts/resume_handoff.ts +373 -373
  19. package/dist/templates/_shared/handoff-system/scripts/save_handoff.ts +469 -469
  20. package/dist/templates/_shared/handoff-system/workflows/handoff-resume.md +66 -66
  21. package/dist/templates/_shared/handoff-system/workflows/handoff.md +254 -254
  22. package/dist/templates/_shared/hooks-ts/_utils/git-state.ts +2 -2
  23. package/dist/templates/_shared/hooks-ts/archive_plan.ts +159 -159
  24. package/dist/templates/_shared/hooks-ts/context_monitor.ts +147 -147
  25. package/dist/templates/_shared/hooks-ts/file-suggestion.ts +128 -128
  26. package/dist/templates/_shared/hooks-ts/pre_compact.ts +49 -49
  27. package/dist/templates/_shared/hooks-ts/session_end.ts +196 -196
  28. package/dist/templates/_shared/hooks-ts/session_start.ts +163 -163
  29. package/dist/templates/_shared/hooks-ts/task_create_capture.ts +48 -48
  30. package/dist/templates/_shared/hooks-ts/task_update_capture.ts +74 -74
  31. package/dist/templates/_shared/hooks-ts/user_prompt_submit.ts +93 -93
  32. package/dist/templates/_shared/lib-ts/CLAUDE.md +367 -367
  33. package/dist/templates/_shared/lib-ts/base/atomic-write.ts +138 -138
  34. package/dist/templates/_shared/lib-ts/base/constants.ts +24 -6
  35. package/dist/templates/_shared/lib-ts/base/git-state.ts +58 -58
  36. package/dist/templates/_shared/lib-ts/base/hook-utils.ts +582 -582
  37. package/dist/templates/_shared/lib-ts/base/inference.ts +301 -301
  38. package/dist/templates/_shared/lib-ts/base/logger.ts +247 -247
  39. package/dist/templates/_shared/lib-ts/base/state-io.ts +202 -202
  40. package/dist/templates/_shared/lib-ts/base/stop-words.ts +184 -184
  41. package/dist/templates/_shared/lib-ts/base/utils.ts +184 -184
  42. package/dist/templates/_shared/lib-ts/context/CLAUDE.md +134 -0
  43. package/dist/templates/_shared/lib-ts/context/context-formatter.ts +566 -566
  44. package/dist/templates/_shared/lib-ts/context/context-selector.ts +524 -524
  45. package/dist/templates/_shared/lib-ts/context/context-store.ts +712 -712
  46. package/dist/templates/_shared/lib-ts/context/plan-manager.ts +312 -312
  47. package/dist/templates/_shared/lib-ts/context/task-tracker.ts +185 -185
  48. package/dist/templates/_shared/lib-ts/package.json +20 -20
  49. package/dist/templates/_shared/lib-ts/templates/formatters.ts +102 -102
  50. package/dist/templates/_shared/lib-ts/templates/plan-context.ts +58 -58
  51. package/dist/templates/_shared/lib-ts/tsconfig.json +13 -13
  52. package/dist/templates/_shared/lib-ts/types.ts +186 -186
  53. package/dist/templates/_shared/scripts/resolve_context.ts +33 -33
  54. package/dist/templates/_shared/scripts/status_line.ts +687 -690
  55. package/dist/templates/cc-native/.claude/commands/cc-native/rlm/ask.md +136 -136
  56. package/dist/templates/cc-native/.claude/commands/cc-native/rlm/index.md +21 -21
  57. package/dist/templates/cc-native/.claude/commands/cc-native/rlm/overview.md +56 -56
  58. package/dist/templates/cc-native/.claude/commands/cc-native/specdev.md +10 -10
  59. package/dist/templates/cc-native/.claude/settings.json +3 -2
  60. package/dist/templates/cc-native/.windsurf/workflows/cc-native/fix.md +8 -8
  61. package/dist/templates/cc-native/.windsurf/workflows/cc-native/implement.md +8 -8
  62. package/dist/templates/cc-native/.windsurf/workflows/cc-native/research.md +8 -8
  63. package/dist/templates/cc-native/CC-NATIVE-README.md +189 -189
  64. package/dist/templates/cc-native/TEMPLATE-SCHEMA.md +304 -304
  65. package/dist/templates/cc-native/_cc-native/agents/CLAUDE.md +143 -143
  66. package/dist/templates/cc-native/_cc-native/agents/PLAN-ORCHESTRATOR.md +213 -213
  67. package/dist/templates/cc-native/_cc-native/agents/plan-questions/PLAN-QUESTIONER.md +70 -70
  68. package/dist/templates/cc-native/_cc-native/artifacts/CLAUDE.md +64 -0
  69. package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/format.ts +1 -1
  70. package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/write.ts +2 -2
  71. package/dist/templates/cc-native/_cc-native/cc-native.config.json +96 -96
  72. package/dist/templates/cc-native/_cc-native/hooks/CLAUDE.md +14 -24
  73. package/dist/templates/cc-native/_cc-native/hooks/cc-native-plan-review.ts +1 -1
  74. package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_subagent.ts +54 -54
  75. package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_write.ts +51 -51
  76. package/dist/templates/cc-native/_cc-native/hooks/mark_questions_asked.ts +53 -53
  77. package/dist/templates/cc-native/_cc-native/hooks/plan_questions_early.ts +61 -61
  78. package/dist/templates/cc-native/_cc-native/hooks/validate_task_prompt.ts +76 -0
  79. package/dist/templates/cc-native/_cc-native/lib-ts/aggregate-agents.ts +9 -2
  80. package/dist/templates/cc-native/_cc-native/lib-ts/cc-native-state.ts +319 -319
  81. package/dist/templates/cc-native/_cc-native/lib-ts/cli-output-parser.ts +144 -144
  82. package/dist/templates/cc-native/_cc-native/lib-ts/config.ts +57 -57
  83. package/dist/templates/cc-native/_cc-native/lib-ts/constants.ts +83 -83
  84. package/dist/templates/cc-native/_cc-native/lib-ts/debug.ts +79 -79
  85. package/dist/templates/cc-native/_cc-native/lib-ts/index.ts +4 -4
  86. package/dist/templates/cc-native/_cc-native/lib-ts/json-parser.ts +168 -168
  87. package/dist/templates/cc-native/_cc-native/lib-ts/plan-discovery.ts +80 -80
  88. package/dist/templates/cc-native/_cc-native/lib-ts/plan-enhancement.ts +41 -41
  89. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/CLAUDE.md +480 -480
  90. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/embedding-indexer.ts +287 -287
  91. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/hyde.ts +148 -148
  92. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/index.ts +54 -54
  93. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/logger.ts +58 -58
  94. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/ollama-client.ts +208 -208
  95. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/retrieval-pipeline.ts +460 -460
  96. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-indexer.ts +446 -446
  97. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-loader.ts +280 -280
  98. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-searcher.ts +274 -274
  99. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/types.ts +201 -201
  100. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/vector-store.ts +278 -278
  101. package/dist/templates/cc-native/_cc-native/lib-ts/settings.ts +184 -184
  102. package/dist/templates/cc-native/_cc-native/lib-ts/state.ts +275 -275
  103. package/dist/templates/cc-native/_cc-native/lib-ts/tsconfig.json +18 -18
  104. package/dist/templates/cc-native/_cc-native/lib-ts/types.ts +1 -1
  105. package/dist/templates/cc-native/_cc-native/plan-review/CLAUDE.md +149 -0
  106. package/dist/templates/cc-native/_cc-native/plan-review/agents/CLAUDE.md +143 -0
  107. package/dist/templates/cc-native/_cc-native/plan-review/agents/PLAN-ORCHESTRATOR.md +213 -0
  108. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-questions/PLAN-QUESTIONER.md +70 -0
  109. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ARCH-EVOLUTION.md +62 -0
  110. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ARCH-PATTERNS.md +61 -0
  111. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ARCH-STRUCTURE.md +62 -0
  112. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ASSUMPTION-TRACER.md +56 -0
  113. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/CLARITY-AUDITOR.md +53 -0
  114. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/COMPLETENESS-FEASIBILITY.md +66 -0
  115. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/COMPLETENESS-GAPS.md +70 -0
  116. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/COMPLETENESS-ORDERING.md +62 -0
  117. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/CONSTRAINT-VALIDATOR.md +72 -0
  118. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DESIGN-ADR-VALIDATOR.md +61 -0
  119. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DESIGN-SCALE-MATCHER.md +64 -0
  120. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DEVILS-ADVOCATE.md +56 -0
  121. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DOCUMENTATION-PHILOSOPHY.md +86 -0
  122. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/HANDOFF-READINESS.md +59 -0
  123. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/HIDDEN-COMPLEXITY.md +58 -0
  124. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/INCREMENTAL-DELIVERY.md +66 -0
  125. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-DEPENDENCY.md +62 -0
  126. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-FMEA.md +66 -0
  127. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-PREMORTEM.md +71 -0
  128. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-REVERSIBILITY.md +74 -0
  129. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/SCOPE-BOUNDARY.md +77 -0
  130. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/SIMPLICITY-GUARDIAN.md +62 -0
  131. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/SKEPTIC.md +68 -0
  132. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-BEHAVIOR-AUDITOR.md +61 -0
  133. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-CHARACTERIZATION.md +71 -0
  134. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-FIRST-VALIDATOR.md +61 -0
  135. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-PYRAMID-ANALYZER.md +61 -0
  136. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TRADEOFF-COSTS.md +67 -0
  137. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TRADEOFF-STAKEHOLDERS.md +65 -0
  138. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/VERIFY-COVERAGE.md +74 -0
  139. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/VERIFY-STRENGTH.md +69 -0
  140. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/agent-selection.ts +3 -3
  141. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/corroboration.ts +1 -1
  142. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/graduation.ts +1 -1
  143. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/orchestrator.ts +2 -2
  144. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/output-builder.ts +3 -3
  145. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/plan-questions.ts +6 -6
  146. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/review-pipeline.ts +15 -15
  147. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/agent.ts +5 -5
  148. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/base/base-agent.ts +4 -4
  149. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/claude-agent.ts +4 -4
  150. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/codex-agent.ts +6 -6
  151. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/gemini-agent.ts +1 -1
  152. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/orchestrator-claude-agent.ts +4 -4
  153. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/types.ts +3 -3
  154. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/verdict.ts +1 -1
  155. package/oclif.manifest.json +1 -1
  156. package/package.json +108 -108
  157. package/dist/templates/cc-native/_cc-native/lib-ts/artifacts.ts +0 -21
  158. package/dist/templates/cc-native/_cc-native/lib-ts/nul +0 -3
  159. /package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/index.ts +0 -0
  160. /package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/tracker.ts +0 -0
  161. /package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/index.ts +0 -0
  162. /package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/schemas.ts +0 -0
  163. /package/dist/templates/cc-native/_cc-native/{workflows → plan-review/workflows}/specdev.md +0 -0
@@ -1,80 +1,80 @@
1
- /**
2
- * Plan file discovery: find, read, and hash the plan file.
3
- * Extracted from cc-native-plan-review.ts.
4
- */
5
-
6
- import * as fs from "node:fs";
7
- import * as path from "node:path";
8
- import * as os from "node:os";
9
- import * as crypto from "node:crypto";
10
-
11
- import { logInfo, logDebug } from "../../_shared/lib-ts/base/logger.js";
12
- import { findPlanPathInTranscript } from "../../_shared/lib-ts/context/plan-manager.js";
13
-
14
- import type { DiscoveredPlan } from "./types.js";
15
-
16
- const HOOK = "plan-discovery";
17
-
18
- /**
19
- * Find the most recently modified plan file in ~/.claude/plans/.
20
- */
21
- export function findPlanFile(): string | null {
22
- const plansDir = path.join(os.homedir(), ".claude", "plans");
23
- if (!fs.existsSync(plansDir)) return null;
24
- const files = fs.readdirSync(plansDir)
25
- .filter(f => f.endsWith(".md"))
26
- .map(f => {
27
- const p = path.join(plansDir, f);
28
- return { path: p, mtime: fs.statSync(p).mtimeMs };
29
- })
30
- .sort((a, b) => b.mtime - a.mtime);
31
- return files.length > 0 ? files[0]!.path : null;
32
- }
33
-
34
- /**
35
- * Compute a short SHA-256 hash of plan content.
36
- */
37
- export function computePlanHash(content: string): string {
38
- return crypto.createHash("sha256").update(content, "utf-8").digest("hex").slice(0, 16);
39
- }
40
-
41
- /**
42
- * Discover the plan file, read its content, and compute its hash.
43
- * Prefers transcript-based discovery (session-accurate), falls back to mtime scan.
44
- */
45
- export function discoverPlan(transcriptPath?: string): DiscoveredPlan | null {
46
- let planPath: string | null = null;
47
-
48
- if (transcriptPath) {
49
- planPath = findPlanPathInTranscript(transcriptPath);
50
- if (planPath) {
51
- logInfo(HOOK, `Found plan via transcript: ${planPath}`);
52
- } else {
53
- logDebug(HOOK, "No plan Write found in transcript, falling back to mtime scan");
54
- }
55
- }
56
-
57
- if (!planPath) {
58
- planPath = findPlanFile();
59
- }
60
-
61
- if (!planPath) return null;
62
-
63
- let content: string;
64
- try {
65
- content = fs.readFileSync(planPath, "utf-8").trim();
66
- } catch {
67
- return null;
68
- }
69
-
70
- if (!content) return null;
71
-
72
- logInfo(HOOK, `Found plan at: ${planPath}`);
73
- logDebug(HOOK, `Plan length: ${content.length} chars`);
74
-
75
- return {
76
- path: planPath,
77
- content,
78
- hash: computePlanHash(content),
79
- };
80
- }
1
+ /**
2
+ * Plan file discovery: find, read, and hash the plan file.
3
+ * Extracted from cc-native-plan-review.ts.
4
+ */
5
+
6
+ import * as fs from "node:fs";
7
+ import * as path from "node:path";
8
+ import * as os from "node:os";
9
+ import * as crypto from "node:crypto";
10
+
11
+ import { logInfo, logDebug } from "../../_shared/lib-ts/base/logger.js";
12
+ import { findPlanPathInTranscript } from "../../_shared/lib-ts/context/plan-manager.js";
13
+
14
+ import type { DiscoveredPlan } from "./types.js";
15
+
16
+ const HOOK = "plan-discovery";
17
+
18
+ /**
19
+ * Find the most recently modified plan file in ~/.claude/plans/.
20
+ */
21
+ export function findPlanFile(): string | null {
22
+ const plansDir = path.join(os.homedir(), ".claude", "plans");
23
+ if (!fs.existsSync(plansDir)) return null;
24
+ const files = fs.readdirSync(plansDir)
25
+ .filter(f => f.endsWith(".md"))
26
+ .map(f => {
27
+ const p = path.join(plansDir, f);
28
+ return { path: p, mtime: fs.statSync(p).mtimeMs };
29
+ })
30
+ .sort((a, b) => b.mtime - a.mtime);
31
+ return files.length > 0 ? files[0]!.path : null;
32
+ }
33
+
34
+ /**
35
+ * Compute a short SHA-256 hash of plan content.
36
+ */
37
+ export function computePlanHash(content: string): string {
38
+ return crypto.createHash("sha256").update(content, "utf-8").digest("hex").slice(0, 16);
39
+ }
40
+
41
+ /**
42
+ * Discover the plan file, read its content, and compute its hash.
43
+ * Prefers transcript-based discovery (session-accurate), falls back to mtime scan.
44
+ */
45
+ export function discoverPlan(transcriptPath?: string): DiscoveredPlan | null {
46
+ let planPath: string | null = null;
47
+
48
+ if (transcriptPath) {
49
+ planPath = findPlanPathInTranscript(transcriptPath);
50
+ if (planPath) {
51
+ logInfo(HOOK, `Found plan via transcript: ${planPath}`);
52
+ } else {
53
+ logDebug(HOOK, "No plan Write found in transcript, falling back to mtime scan");
54
+ }
55
+ }
56
+
57
+ if (!planPath) {
58
+ planPath = findPlanFile();
59
+ }
60
+
61
+ if (!planPath) return null;
62
+
63
+ let content: string;
64
+ try {
65
+ content = fs.readFileSync(planPath, "utf-8").trim();
66
+ } catch {
67
+ return null;
68
+ }
69
+
70
+ if (!content) return null;
71
+
72
+ logInfo(HOOK, `Found plan at: ${planPath}`);
73
+ logDebug(HOOK, `Plan length: ${content.length} chars`);
74
+
75
+ return {
76
+ path: planPath,
77
+ content,
78
+ hash: computePlanHash(content),
79
+ };
80
+ }
@@ -1,41 +1,41 @@
1
- /**
2
- * Plan quality guidance for context emission.
3
- *
4
- * Provides prompt text that guides the main agent to review plans before
5
- * presenting them to the user. Emitted via emitContext() — NOT appended to plan files.
6
- *
7
- * Used by both SubagentStop hook (Plan agents) and PostToolUse:Write hook (direct writes).
8
- */
9
-
10
- /**
11
- * Returns the plan quality review prompt to emit as context after a plan is written.
12
- * This guides the main agent to review the plan before calling ExitPlanMode.
13
- *
14
- * Design principles:
15
- * - No hardcoded skill names — agent discovers relevant skills from system-reminders
16
- * - Documentation focuses on WHY (preserve decisions) not WHERE (file paths)
17
- * - Concise — every token in emitted context costs attention budget
18
- * - Trusts the agent's judgment — guidance, not mandate
19
- */
20
- export function getPlanQualityReviewContext(): string {
21
- return `## Plan Quality Review
22
-
23
- Before presenting this plan, review it from the perspective of an agent with zero conversation history.
24
-
25
- ### Self-Check
26
- - File paths are absolute and verified (not "the auth file" or "as discussed")
27
- - Function and class names are exact references (not "the handler" or "it")
28
- - Each step is specific enough to execute without this conversation's context
29
- - Verification steps are binary-testable (pass/fail in one check)
30
-
31
- ### Skills Integration
32
- Review the skills listed in your system-reminder messages. Where a step would benefit from a specific skill, reference it inline (e.g., "Use \`SkillName\` skill for [specific purpose]"). Only reference skills relevant to this plan's domain.
33
-
34
- ### Documentation Reasoning
35
- Evaluate whether the plan captures decisions that would be lost when this session ends. The implementation agent should understand:
36
- - What was decided and why alternatives were rejected
37
- - What constraints exist that aren't obvious from the code
38
- - What would break if assumptions change
39
-
40
- If the plan has gaps, address them before presenting to the user.`;
41
- }
1
+ /**
2
+ * Plan quality guidance for context emission.
3
+ *
4
+ * Provides prompt text that guides the main agent to review plans before
5
+ * presenting them to the user. Emitted via emitContext() — NOT appended to plan files.
6
+ *
7
+ * Used by both SubagentStop hook (Plan agents) and PostToolUse:Write hook (direct writes).
8
+ */
9
+
10
+ /**
11
+ * Returns the plan quality review prompt to emit as context after a plan is written.
12
+ * This guides the main agent to review the plan before calling ExitPlanMode.
13
+ *
14
+ * Design principles:
15
+ * - No hardcoded skill names — agent discovers relevant skills from system-reminders
16
+ * - Documentation focuses on WHY (preserve decisions) not WHERE (file paths)
17
+ * - Concise — every token in emitted context costs attention budget
18
+ * - Trusts the agent's judgment — guidance, not mandate
19
+ */
20
+ export function getPlanQualityReviewContext(): string {
21
+ return `## Plan Quality Review
22
+
23
+ Before presenting this plan, review it from the perspective of an agent with zero conversation history.
24
+
25
+ ### Self-Check
26
+ - File paths are absolute and verified (not "the auth file" or "as discussed")
27
+ - Function and class names are exact references (not "the handler" or "it")
28
+ - Each step is specific enough to execute without this conversation's context
29
+ - Verification steps are binary-testable (pass/fail in one check)
30
+
31
+ ### Skills Integration
32
+ Review the skills listed in your system-reminder messages. Where a step would benefit from a specific skill, reference it inline (e.g., "Use \`SkillName\` skill for [specific purpose]"). Only reference skills relevant to this plan's domain.
33
+
34
+ ### Documentation Reasoning
35
+ Evaluate whether the plan captures decisions that would be lost when this session ends. The implementation agent should understand:
36
+ - What was decided and why alternatives were rejected
37
+ - What constraints exist that aren't obvious from the code
38
+ - What would break if assumptions change
39
+
40
+ If the plan has gaps, address them before presenting to the user.`;
41
+ }