@vpxa/aikit 0.1.74 → 0.1.75

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 (134) hide show
  1. package/package.json +6 -1
  2. package/packages/cli/dist/index.js +2 -2
  3. package/packages/cli/dist/{init-DQkar6Es.js → init-CuRXmyD9.js} +1 -1
  4. package/packages/cli/dist/scaffold-WMQ2uQ48.js +2 -0
  5. package/packages/cli/dist/{user-CopNWxHP.js → user-vbJwa7x2.js} +1 -1
  6. package/scaffold/dist/adapters/claude-code.mjs +4 -0
  7. package/scaffold/dist/adapters/copilot.mjs +75 -0
  8. package/scaffold/dist/adapters/flows.mjs +1 -0
  9. package/scaffold/dist/adapters/skills.mjs +1 -0
  10. package/scaffold/{compiled → dist/compiled}/flows-data.mjs +304 -446
  11. package/scaffold/{compiled → dist/compiled}/skills-data.mjs +554 -2281
  12. package/scaffold/dist/definitions/agents.mjs +9 -0
  13. package/scaffold/{definitions → dist/definitions}/bodies.mjs +6 -229
  14. package/scaffold/dist/definitions/exclusions.mjs +1 -0
  15. package/scaffold/dist/definitions/hooks.mjs +1 -0
  16. package/scaffold/dist/definitions/models.mjs +1 -0
  17. package/scaffold/dist/definitions/plugins.mjs +1 -0
  18. package/scaffold/{definitions → dist/definitions}/prompts.mjs +9 -149
  19. package/scaffold/{definitions → dist/definitions}/protocols.mjs +9 -37
  20. package/scaffold/dist/definitions/tools.mjs +1 -0
  21. package/packages/cli/dist/scaffold-ukCDW3wQ.js +0 -2
  22. package/scaffold/_preview/agents/Architect-Reviewer-Alpha.agent.md +0 -132
  23. package/scaffold/_preview/agents/Architect-Reviewer-Beta.agent.md +0 -132
  24. package/scaffold/_preview/agents/Code-Reviewer-Alpha.agent.md +0 -112
  25. package/scaffold/_preview/agents/Code-Reviewer-Beta.agent.md +0 -112
  26. package/scaffold/_preview/agents/Debugger.agent.md +0 -412
  27. package/scaffold/_preview/agents/Documenter.agent.md +0 -468
  28. package/scaffold/_preview/agents/Explorer.agent.md +0 -76
  29. package/scaffold/_preview/agents/Frontend.agent.md +0 -440
  30. package/scaffold/_preview/agents/Implementer.agent.md +0 -425
  31. package/scaffold/_preview/agents/Orchestrator.agent.md +0 -452
  32. package/scaffold/_preview/agents/Planner.agent.md +0 -481
  33. package/scaffold/_preview/agents/README.md +0 -57
  34. package/scaffold/_preview/agents/Refactor.agent.md +0 -435
  35. package/scaffold/_preview/agents/Researcher-Alpha.agent.md +0 -151
  36. package/scaffold/_preview/agents/Researcher-Beta.agent.md +0 -152
  37. package/scaffold/_preview/agents/Researcher-Delta.agent.md +0 -153
  38. package/scaffold/_preview/agents/Researcher-Gamma.agent.md +0 -152
  39. package/scaffold/_preview/agents/Security.agent.md +0 -433
  40. package/scaffold/_preview/agents/_shared/architect-reviewer-base.md +0 -104
  41. package/scaffold/_preview/agents/_shared/code-agent-base.md +0 -366
  42. package/scaffold/_preview/agents/_shared/code-reviewer-base.md +0 -87
  43. package/scaffold/_preview/agents/_shared/decision-protocol.md +0 -27
  44. package/scaffold/_preview/agents/_shared/forge-protocol.md +0 -90
  45. package/scaffold/_preview/agents/_shared/researcher-base.md +0 -114
  46. package/scaffold/_preview/agents/templates/adr-template.md +0 -28
  47. package/scaffold/_preview/agents/templates/execution-state.md +0 -26
  48. package/scaffold/_preview/flows/_epilogue/steps/docs-sync/README.md +0 -120
  49. package/scaffold/_preview/flows/aikit-advanced/README.md +0 -70
  50. package/scaffold/_preview/flows/aikit-advanced/steps/design/README.md +0 -178
  51. package/scaffold/_preview/flows/aikit-advanced/steps/execute/README.md +0 -145
  52. package/scaffold/_preview/flows/aikit-advanced/steps/plan/README.md +0 -122
  53. package/scaffold/_preview/flows/aikit-advanced/steps/spec/README.md +0 -121
  54. package/scaffold/_preview/flows/aikit-advanced/steps/task/README.md +0 -119
  55. package/scaffold/_preview/flows/aikit-advanced/steps/verify/README.md +0 -145
  56. package/scaffold/_preview/flows/aikit-basic/README.md +0 -51
  57. package/scaffold/_preview/flows/aikit-basic/steps/assess/README.md +0 -109
  58. package/scaffold/_preview/flows/aikit-basic/steps/design/README.md +0 -116
  59. package/scaffold/_preview/flows/aikit-basic/steps/implement/README.md +0 -131
  60. package/scaffold/_preview/flows/aikit-basic/steps/verify/README.md +0 -123
  61. package/scaffold/_preview/prompts/aikit-ask.prompt.md +0 -13
  62. package/scaffold/_preview/prompts/aikit-debug.prompt.md +0 -15
  63. package/scaffold/_preview/prompts/aikit-design.prompt.md +0 -15
  64. package/scaffold/_preview/prompts/aikit-flow-add.prompt.md +0 -84
  65. package/scaffold/_preview/prompts/aikit-flow-create.prompt.md +0 -80
  66. package/scaffold/_preview/prompts/aikit-flow-manage.prompt.md +0 -24
  67. package/scaffold/_preview/prompts/aikit-implement.prompt.md +0 -17
  68. package/scaffold/_preview/prompts/aikit-plan.prompt.md +0 -15
  69. package/scaffold/_preview/prompts/aikit-review.prompt.md +0 -24
  70. package/scaffold/_preview/skills/adr-skill/SKILL.md +0 -335
  71. package/scaffold/_preview/skills/adr-skill/assets/templates/adr-madr.md +0 -89
  72. package/scaffold/_preview/skills/adr-skill/assets/templates/adr-readme.md +0 -20
  73. package/scaffold/_preview/skills/adr-skill/assets/templates/adr-simple.md +0 -46
  74. package/scaffold/_preview/skills/adr-skill/references/adr-conventions.md +0 -95
  75. package/scaffold/_preview/skills/adr-skill/references/examples.md +0 -193
  76. package/scaffold/_preview/skills/adr-skill/references/review-checklist.md +0 -77
  77. package/scaffold/_preview/skills/adr-skill/references/template-variants.md +0 -52
  78. package/scaffold/_preview/skills/adr-skill/scripts/bootstrap_adr.js +0 -259
  79. package/scaffold/_preview/skills/adr-skill/scripts/new_adr.js +0 -391
  80. package/scaffold/_preview/skills/adr-skill/scripts/set_adr_status.js +0 -169
  81. package/scaffold/_preview/skills/aikit/SKILL.md +0 -754
  82. package/scaffold/_preview/skills/brainstorming/SKILL.md +0 -265
  83. package/scaffold/_preview/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  84. package/scaffold/_preview/skills/c4-architecture/SKILL.md +0 -389
  85. package/scaffold/_preview/skills/c4-architecture/references/advanced-patterns.md +0 -552
  86. package/scaffold/_preview/skills/c4-architecture/references/c4-syntax.md +0 -510
  87. package/scaffold/_preview/skills/c4-architecture/references/common-mistakes.md +0 -437
  88. package/scaffold/_preview/skills/c4-architecture/references/html-design-system.md +0 -337
  89. package/scaffold/_preview/skills/c4-architecture/references/html-template.html +0 -627
  90. package/scaffold/_preview/skills/docs/SKILL.md +0 -553
  91. package/scaffold/_preview/skills/docs/references/diataxis-anti-patterns.md +0 -147
  92. package/scaffold/_preview/skills/docs/references/diataxis-compass.md +0 -123
  93. package/scaffold/_preview/skills/docs/references/diataxis-quadrants.md +0 -192
  94. package/scaffold/_preview/skills/docs/references/diataxis-quality.md +0 -76
  95. package/scaffold/_preview/skills/docs/references/diataxis-templates.md +0 -120
  96. package/scaffold/_preview/skills/docs/references/flow-artifacts-guide.md +0 -70
  97. package/scaffold/_preview/skills/docs/references/project-knowledge-gotchas.md +0 -32
  98. package/scaffold/_preview/skills/docs/references/project-knowledge-templates.md +0 -281
  99. package/scaffold/_preview/skills/docs/references/project-knowledge-workflow.md +0 -80
  100. package/scaffold/_preview/skills/frontend-design/SKILL.md +0 -237
  101. package/scaffold/_preview/skills/lesson-learned/SKILL.md +0 -113
  102. package/scaffold/_preview/skills/lesson-learned/references/anti-patterns.md +0 -55
  103. package/scaffold/_preview/skills/lesson-learned/references/se-principles.md +0 -109
  104. package/scaffold/_preview/skills/multi-agents-development/SKILL.md +0 -448
  105. package/scaffold/_preview/skills/multi-agents-development/architecture-review-prompt.md +0 -81
  106. package/scaffold/_preview/skills/multi-agents-development/code-quality-review-prompt.md +0 -91
  107. package/scaffold/_preview/skills/multi-agents-development/implementer-prompt.md +0 -93
  108. package/scaffold/_preview/skills/multi-agents-development/parallel-dispatch-example.md +0 -167
  109. package/scaffold/_preview/skills/multi-agents-development/spec-review-prompt.md +0 -81
  110. package/scaffold/_preview/skills/present/SKILL.md +0 -616
  111. package/scaffold/_preview/skills/react/SKILL.md +0 -309
  112. package/scaffold/_preview/skills/repo-access/SKILL.md +0 -178
  113. package/scaffold/_preview/skills/repo-access/references/error-patterns.md +0 -116
  114. package/scaffold/_preview/skills/repo-access/references/platform-matrix.md +0 -142
  115. package/scaffold/_preview/skills/requirements-clarity/SKILL.md +0 -333
  116. package/scaffold/_preview/skills/session-handoff/SKILL.md +0 -199
  117. package/scaffold/_preview/skills/session-handoff/references/handoff-template.md +0 -139
  118. package/scaffold/_preview/skills/session-handoff/references/resume-checklist.md +0 -80
  119. package/scaffold/_preview/skills/session-handoff/scripts/check_staleness.js +0 -269
  120. package/scaffold/_preview/skills/session-handoff/scripts/create_handoff.js +0 -299
  121. package/scaffold/_preview/skills/session-handoff/scripts/list_handoffs.js +0 -113
  122. package/scaffold/_preview/skills/session-handoff/scripts/validate_handoff.js +0 -241
  123. package/scaffold/_preview/skills/typescript/SKILL.md +0 -405
  124. package/scaffold/adapters/claude-code.mjs +0 -73
  125. package/scaffold/adapters/copilot.mjs +0 -292
  126. package/scaffold/adapters/flows.mjs +0 -27
  127. package/scaffold/adapters/skills.mjs +0 -25
  128. package/scaffold/definitions/agents.mjs +0 -266
  129. package/scaffold/definitions/exclusions.mjs +0 -58
  130. package/scaffold/definitions/hooks.mjs +0 -43
  131. package/scaffold/definitions/models.mjs +0 -84
  132. package/scaffold/definitions/plugins.mjs +0 -147
  133. package/scaffold/definitions/tools.mjs +0 -250
  134. package/scaffold/generate.mjs +0 -92
@@ -1,116 +0,0 @@
1
- # Design Gate — Basic Flow
2
-
3
- Lightweight design gate for bug fixes, small features, and refactoring. Evaluates the task type and determines whether design work is needed before proceeding.
4
-
5
- ## When This Step Runs
6
-
7
- This is the **first step** of the `aikit:basic` flow. It runs before assessment.
8
-
9
- ## Instructions
10
-
11
- ### 1. Task Classification
12
-
13
- Classify the task into one of these categories:
14
-
15
- | Category | Indicators | Action |
16
- |----------|-----------|--------|
17
- | **Bug fix** | Error reports, stack traces, regression, "fix", "broken" | → **Auto-skip** to next step |
18
- | **Refactor** | Code cleanup, rename, restructure, no behavior change | → **Auto-skip** to next step |
19
- | **Small feature** | New behavior, new endpoint, new component, UI change | → Run **Quick Design** below |
20
-
21
- **If the task is a bug fix or refactor**, write `{{artifacts_path}}/design-decisions.md` to disk:
22
- ```markdown
23
- ## Design Decisions
24
- - **Task type**: Bug fix / Refactor
25
- - **Design gate**: Auto-skipped — no design work needed
26
- - **Proceed to**: Assessment
27
- ```
28
- **You MUST create this file on disk** at the exact `{{artifacts_path}}/design-decisions.md` path — do not just present the content in chat.
29
- Then report `DONE` to the Orchestrator so the flow advances.
30
-
31
- ### 2. Quick Design (Small Features Only)
32
-
33
- For small features that need minimal design:
34
-
35
- 1. **FORGE Classify** — Run `forge_classify({ task: "<task description>", files: [<relevant files>] })` to determine complexity tier
36
- 2. **Brainstorming** (if tier ≥ Standard) — Load the `brainstorming` skill and run a focused brainstorming session:
37
- - What is the user trying to achieve?
38
- - What are the constraints?
39
- - What is the simplest approach?
40
- 3. **Decision Protocol** (if technical decisions exist) — Delegate to 2-4 Researcher agents in parallel:
41
- - Each researcher evaluates a different approach
42
- - Synthesize findings into a recommendation
43
- 4. **Write `{{artifacts_path}}/design-decisions.md`** to disk:
44
-
45
- ```markdown
46
- ## Design Decisions
47
-
48
- ### FORGE Assessment
49
- - **Tier**: {Floor | Standard | Critical}
50
- - **Rationale**: {why this tier}
51
-
52
- ### Task Summary
53
- - **Goal**: {what we're building}
54
- - **Approach**: {chosen approach}
55
- - **Key decisions**: {list}
56
-
57
- ### Constraints
58
- - {constraint 1}
59
- - {constraint 2}
60
- ```
61
-
62
- ### 3. Report to Orchestrator
63
-
64
- When complete, report status:
65
- - `DONE` — design decisions captured, ready for assessment
66
- - `DONE_WITH_CONCERNS` — design captured but open questions remain (list them)
67
-
68
- **Do NOT call `flow_step`** — let the Orchestrator advance the flow.
69
-
70
- ## Outputs
71
-
72
- Write `{{artifacts_path}}/design-decisions.md` to disk. **You MUST create this file** using `create_file` or equivalent — do not just present content in chat. This file is a prerequisite for the next step.
73
-
74
- ## Produces
75
-
76
- - `{{artifacts_path}}/design-decisions.md` — Task classification, FORGE tier, key design decisions
77
-
78
- ## Agents
79
-
80
- - `Researcher-Alpha`, `Researcher-Beta`, `Researcher-Gamma`, `Researcher-Delta` — for parallel research during decision protocol
81
-
82
- ## Foundation Integration
83
-
84
- Load these skills BEFORE executing this step:
85
-
86
- | Skill | Purpose | When |
87
- |-------|---------|------|
88
- | `aikit` | Core MCP tools — search, analyze, remember, validate | Always (auto-loaded) |
89
- | `present` | Rich rendering for any structured output — assessments, reports, comparisons, reviews, status boards, tables, charts, and all artifact content | Use for ANY output that benefits from rich rendering, not just dashboards |
90
- | `multi-agents-development` | Dispatch templates, task decomposition, review pipeline patterns | Before dispatching any subagent |
91
- | `brainstorming` | Structured ideation for design/creative decisions | Before any design choice or new feature exploration |
92
- | `c4-architecture` | C4 model architecture diagrams — system context, container, component, deployment views | When visualizing system structure during design |
93
- | `adr-skill` | Architecture Decision Records — create, review, maintain ADRs | When making non-trivial design or technology decisions |
94
-
95
- ### Presentation Rules
96
- - Use `present` for **any output** that benefits from rich rendering — not limited to dashboards
97
- - Assessments, reports, comparisons, reviews, status boards → `present({ format: "html" })`
98
- - Tables, charts, progress tracking, code review findings → always present
99
- - Artifact content and summaries → present with structured layout
100
- - Only use plain text for brief confirmations and simple questions
101
-
102
- ## Completion Criteria
103
-
104
- - [ ] `{{artifacts_path}}/design-decisions.md` written to disk (NOT just presented in chat)
105
- - [ ] FORGE tier determined (for small features)
106
- - [ ] Key design decisions documented
107
-
108
- ## Knowledge Capture
109
-
110
- Before completing this step, persist important findings using `remember()`:
111
-
112
- - **Design decisions**: Chosen approach and alternatives considered with trade-offs
113
- - **Architecture patterns**: New patterns introduced or existing patterns that must be followed
114
- - **Constraints discovered**: Technical limitations, compatibility requirements, or performance boundaries
115
-
116
- **Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call `remember()` now.
@@ -1,131 +0,0 @@
1
- ---
2
- name: implement
3
- description: Write code following the assessment plan, using TDD practices where applicable.
4
- ---
5
-
6
- # Implementation
7
-
8
- ## Purpose
9
-
10
- Execute the implementation plan from the assessment, writing production code and tests.
11
-
12
- ## Inputs
13
-
14
- - `{{artifacts_path}}/assessment.md` — the approach, affected files, and risks
15
-
16
- ## Prerequisites Check
17
-
18
- Before executing this step, verify:
19
-
20
- - [ ] Assessment complete and scope approved (from the assess step)
21
- - [ ] Files-to-modify list is clear and bounded
22
- - [ ] `check({})` baseline captured (know what currently passes)
23
-
24
- If any prerequisites are missing or incomplete:
25
- 1. Inform the Orchestrator with specifics about what's missing
26
- 2. Recommend `flow_step({ action: 'redo' })` on the **assess** step
27
- 3. Do NOT proceed with partial inputs — quality degrades downstream
28
-
29
- ## Process
30
-
31
- 1. **Read assessment** — Load `{{artifacts_path}}/assessment.md` and internalize the approach
32
- 2. **Set up tests first** — Where applicable, write failing tests that define success
33
- 3. **Implement changes** — Follow the approach steps sequentially
34
- - One logical change per commit-worthy chunk
35
- - Stay within the assessed file scope — do not expand without re-assessment
36
- 4. **Run validation** — `check({})` for type/lint errors, `test_run({})` for test results
37
- 5. **Fix issues** — Iterate until `check` and `test_run` pass (max 3 rounds)
38
- 6. **Document progress** — Write progress artifact with what was done and any deviations
39
-
40
- ## Outputs
41
-
42
- Write `{{artifacts_path}}/progress.md` to disk. **You MUST create this file** using `create_file` or equivalent — do not just present content in chat.
43
-
44
- Template:
45
-
46
- ```markdown
47
- # Implementation Progress: <task title>
48
-
49
- ## Changes Made
50
- <list of files changed with brief description>
51
-
52
- ## Tests
53
- <tests added or modified>
54
-
55
- ## Deviations from Assessment
56
- <any changes to the original plan and why>
57
-
58
- ## Validation
59
- - check: PASS/FAIL
60
- - test_run: PASS/FAIL (<N> passed, <M> failed)
61
-
62
- ## Notes
63
- <anything the reviewer should know>
64
- ```
65
-
66
- ## Agents
67
-
68
- | Agent | Role |
69
- |-------|------|
70
- | **Implementer** | Primary code writer — follows TDD, writes production code and tests |
71
- | **Frontend** | UI/UX specialist — use when changes involve React components, styling, or responsive design |
72
-
73
- Dispatch Implementer for backend/logic changes, Frontend for UI changes. Both can run in parallel if working on different files.
74
-
75
- ## Foundation Integration
76
-
77
- Load these skills BEFORE executing this step:
78
-
79
- | Skill | Purpose | When |
80
- |-------|---------|------|
81
- | `aikit` | Core MCP tools — search, analyze, remember, validate | Always (auto-loaded) |
82
- | `present` | Rich rendering for any structured output — assessments, reports, comparisons, reviews, status boards, tables, charts, and all artifact content | Use for ANY output that benefits from rich rendering, not just dashboards |
83
- | `multi-agents-development` | Dispatch templates, task decomposition, review pipeline patterns | Before dispatching any subagent |
84
- | `brainstorming` | Structured ideation for design/creative decisions | Before any design choice or new feature exploration |
85
- | `session-handoff` | Context preservation for session transfers | When implementation is long-running and context may fill up |
86
-
87
- ### Presentation Rules
88
- - Use `present` for **any output** that benefits from rich rendering — not limited to dashboards
89
- - Assessments, reports, comparisons, reviews, status boards → `present({ format: "html" })`
90
- - Tables, charts, progress tracking, code review findings → always present
91
- - Artifact content and summaries → present with structured layout
92
- - Only use plain text for brief confirmations and simple questions
93
-
94
- ### Orchestrator Dispatch Protocol
95
-
96
- Follow the `multi-agents-development` skill patterns for dispatch:
97
-
98
- 1. **Independence Check** before parallelizing:
99
- - Same files? → sequential
100
- - Shared mutable state? → sequential
101
- - Execution-order dependent? → sequential
102
- - Need shared new types? → define contract first, then parallel
103
- - All clear? → **parallel dispatch**
104
-
105
- 2. **Subagent Context Template** (each dispatch includes):
106
- - **Scope**: exact files + boundary (do NOT touch)
107
- - **Goal**: acceptance criteria, testable
108
- - **Arch Context**: actual code snippets via `compact()`/`digest()`
109
- - **Constraints**: patterns, conventions, anti-patterns
110
- - **Self-Review**: checklist before declaring DONE
111
-
112
- 3. **Status Protocol**: `DONE` | `DONE_WITH_CONCERNS` | `NEEDS_CONTEXT` | `BLOCKED`
113
- 4. **Max 2 retries** per task — then escalate to user
114
-
115
- ## Completion Criteria
116
-
117
- - [ ] All assessment steps implemented
118
- - [ ] `check({})` passes (no type/lint errors)
119
- - [ ] `test_run({})` passes (no test failures)
120
- - [ ] No files modified outside assessed scope
121
- - [ ] `{{artifacts_path}}/progress.md` written
122
-
123
- ## Knowledge Capture
124
-
125
- Before completing this step, persist important findings using `remember()`:
126
-
127
- - **Implementation decisions**: Why specific approaches were chosen over alternatives
128
- - **Patterns established**: New conventions or patterns that future code should follow
129
- - **Gotchas encountered**: Edge cases, workarounds, or non-obvious behaviors discovered during implementation
130
-
131
- **Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call `remember()` now.
@@ -1,123 +0,0 @@
1
- ---
2
- name: verify
3
- description: Review code changes, run tests, validate correctness and quality.
4
- ---
5
-
6
- # Verification
7
-
8
- ## Purpose
9
-
10
- Validate that the implementation meets the original requirements, passes all quality gates, and introduces no regressions.
11
-
12
- ## Inputs
13
-
14
- - `{{artifacts_path}}/assessment.md` — original requirements and approach
15
- - `{{artifacts_path}}/progress.md` — what was implemented and any deviations
16
-
17
- ## Prerequisites Check
18
-
19
- Before executing this step, verify:
20
-
21
- - [ ] Implementation complete (from the implement step)
22
- - [ ] `check({})` + `test_run({})` pass at baseline
23
- - [ ] Changed files list is available for blast radius analysis
24
-
25
- If any prerequisites are missing or incomplete:
26
- 1. Inform the Orchestrator with specifics about what's missing
27
- 2. Recommend `flow_step({ action: 'redo' })` on the **implement** step
28
- 3. Do NOT proceed with partial inputs — quality degrades downstream
29
-
30
- ## Process
31
-
32
- 1. **Load context** — Read assessment and progress artifacts
33
- 2. **Code review** — Review all changed files for:
34
- - Correctness against requirements
35
- - Code quality and adherence to project conventions
36
- - Error handling and edge cases
37
- - No unnecessary changes (scope creep)
38
- 3. **Run quality gates** — `check({})` + `test_run({})` must pass
39
- 4. **Blast radius** — `blast_radius({ changed_files: [...] })` to assess impact
40
- 5. **Security scan** — Check for OWASP Top 10 issues in changed code
41
- 6. **Write report** — Document findings with PASS/FAIL verdict
42
-
43
- ## Outputs
44
-
45
- Write `{{artifacts_path}}/verify-report.md` to disk. **You MUST create this file** using `create_file` or equivalent — do not just present content in chat.
46
-
47
- Template:
48
-
49
- ```markdown
50
- # Verification Report: <task title>
51
-
52
- ## Verdict: PASS | FAIL
53
-
54
- ## Quality Gates
55
- - check: PASS/FAIL
56
- - test_run: PASS/FAIL (<N> passed, <M> failed)
57
- - blast_radius: <summary of impact>
58
-
59
- ## Code Review Findings
60
- <issues found, if any, with severity>
61
-
62
- ## Security
63
- <any security concerns>
64
-
65
- ## Recommendation
66
- <APPROVE for commit / REQUEST CHANGES with specific items>
67
- ```
68
-
69
- ## Agents
70
-
71
- | Agent | Role |
72
- |-------|------|
73
- | **Code-Reviewer-Alpha** | Primary code reviewer — correctness, quality, conventions |
74
- | **Security** | Security specialist — vulnerability analysis, OWASP compliance |
75
-
76
- Run both in parallel — they review different aspects of the same changes.
77
-
78
- ## Foundation Integration
79
-
80
- Load these skills BEFORE executing this step:
81
-
82
- | Skill | Purpose | When |
83
- |-------|---------|------|
84
- | `aikit` | Core MCP tools — search, analyze, remember, validate | Always (auto-loaded) |
85
- | `present` | Rich rendering for any structured output — assessments, reports, comparisons, reviews, status boards, tables, charts, and all artifact content | Use for ANY output that benefits from rich rendering, not just dashboards |
86
- | `multi-agents-development` | Dispatch templates, task decomposition, review pipeline patterns | Before dispatching any subagent |
87
- | `brainstorming` | Structured ideation for design/creative decisions | Before any design choice or new feature exploration |
88
- | `lesson-learned` | Extract engineering lessons from completed work via git history | After verification completes — capture principles from what was built |
89
- | `session-handoff` | Context preservation for session transfers | When verification is the final step and session context should be saved |
90
-
91
- ### Presentation Rules
92
- - Use `present` for **any output** that benefits from rich rendering — not limited to dashboards
93
- - Assessments, reports, comparisons, reviews, status boards → `present({ format: "html" })`
94
- - Tables, charts, progress tracking, code review findings → always present
95
- - Artifact content and summaries → present with structured layout
96
- - Only use plain text for brief confirmations and simple questions
97
-
98
- ### FORGE Quality Gate
99
-
100
- After all reviews complete:
101
- 1. `evidence_map({ action: "gate", task_id: "<slug>" })` → returns YIELD/HOLD/HARD_BLOCK
102
- 2. YIELD → approved, proceed to commit
103
- 3. HOLD → minor issues, fix then re-gate (max 3 rounds)
104
- 4. HARD_BLOCK → critical issues, escalate to user
105
-
106
- ## Completion Criteria
107
-
108
- - [ ] `check({})` passes
109
- - [ ] `test_run({})` passes
110
- - [ ] Code review complete with no blocking issues
111
- - [ ] Security review complete
112
- - [ ] Blast radius assessed
113
- - [ ] `{{artifacts_path}}/verify-report.md` written with clear PASS/FAIL verdict
114
-
115
- ## Knowledge Capture
116
-
117
- Before completing this step, persist important findings using `remember()`:
118
-
119
- - **Test coverage gaps**: Areas that couldn't be fully tested and why
120
- - **Quality findings**: Issues found during verification and their resolutions
121
- - **Session checkpoint**: Summarize what was accomplished, decisions made, and any remaining work
122
-
123
- **Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call `remember()` now.
@@ -1,13 +0,0 @@
1
- ---
2
- description: "Quick research question — find answer using AI Kit + web search"
3
- agent: "Researcher-Alpha"
4
- ---
5
-
6
- ## Quick Research
7
-
8
- 1. **AI Kit Recall** — Search knowledge base for existing answers
9
- 2. **Web Search** — If AI Kit has no relevant results, search the web
10
- 3. **Synthesize** — Combine findings into a clear, concise answer
11
- 4. **Remember** — If the answer is broadly useful, persist it to KB
12
-
13
- **Always cite sources** — AI Kit entries, file paths, or URLs.
@@ -1,15 +0,0 @@
1
- ---
2
- description: "Systematic error diagnosis: reproduce → trace → diagnose → fix → verify"
3
- agent: "Debugger"
4
- ---
5
-
6
- ## Debug Workflow
7
-
8
- 1. **Parse Error** — Use `parse_output` on the error message/stack trace
9
- 2. **AI Kit Recall** — Search for known issues matching this pattern
10
- 3. **Reproduce** — Run the failing command/test to confirm
11
- 4. **Trace** — Use `symbol` and `trace` to follow the call chain
12
- 5. **Diagnose** — Form hypothesis, gather evidence
13
- 6. **Fix** — Implement minimal fix
14
- 7. **Verify** — `check` + `test_run` to confirm fix and no regressions
15
- 8. **Remember** — Persist the fix with category `troubleshooting`
@@ -1,15 +0,0 @@
1
- ---
2
- description: "Collaborative design session — explore ideas, refine requirements, produce a design spec"
3
- agent: "Orchestrator"
4
- ---
5
-
6
- ## Design Session
7
-
8
- Enter Phase 0 (Design Gate) directly — the user is requesting a design session.
9
-
10
- 1. **Invoke the brainstorming skill** — interactive design dialogue with user
11
- 2. Follow the skill's full process (auto-selects Simple or Advanced mode)
12
- 3. If Advanced Mode, use Decision Protocol for unresolved technical choices
13
- 4. Terminal state: brainstorming skill invokes writing-plans skill
14
-
15
- **🛑 HARD GATE** — Do NOT skip brainstorming. Do NOT write code. Design first.
@@ -1,84 +0,0 @@
1
- ---
2
- description: "Install a new flow from a git URL or local path — with interactive error recovery"
3
- agent: "Orchestrator"
4
- ---
5
-
6
- ## Flow Installation Assistant
7
-
8
- Install a development flow from a git repository or local directory.
9
-
10
- ### Usage
11
- Provide a git URL or local path:
12
- - `https://github.com/org/my-flow.git`
13
- - `git@github.com:org/my-flow.git`
14
- - `./path/to/local/flow`
15
- - `C:\Users\name\flows\my-flow`
16
-
17
- ### Workflow
18
-
19
- 1. **Attempt Install** — Call `flow_add` with the provided source
20
- 2. **On Success** — Show installed flow info with `flow_info`, present summary to user
21
- 3. **On Failure** — Classify the error and enter the appropriate recovery path:
22
-
23
- ### Error Recovery Paths
24
-
25
- #### Git Authentication Failure
26
- If the error mentions authentication, credentials, 401, 403, permission denied, or SAML:
27
-
28
- 1. Present the error clearly to the user
29
- 2. Ask which auth method they prefer:
30
- - **SSH key**: Walk through `ssh-keygen -t ed25519`, adding the public key to their git host, and retrying with the SSH URL
31
- - **Personal Access Token (PAT)**: Guide them to create a PAT in their git host settings, configure `git credential.helper store`, and retry
32
- - **Git Credential Manager**: Check if GCM is installed, help install if needed, then retry (GCM opens a browser for auth)
33
- 3. After credentials are configured, retry `flow_add`
34
-
35
- #### Network / Connectivity Failure
36
- If the error mentions timeout, host not found, SSL, or proxy:
37
-
38
- 1. Present diagnostics: Is VPN needed? Is the URL correct? Is there a proxy?
39
- 2. Guide the user through resolution
40
- 3. Retry after the issue is resolved
41
-
42
- #### Format Not Recognized
43
- If `flow_add` succeeds cloning but returns a format/structure error:
44
-
45
- 1. Explain that the source was fetched but doesn't match any supported format
46
- 2. List the 3 supported formats:
47
- - **Native**: Has a `flow.json` manifest in the root
48
- - **Claude Plugin**: Has `.claude-plugin/plugin.json` with skills as steps
49
- - **Copilot Agents**: Has `.github/agents/` with agent .md files as steps
50
- 3. Analyze the source structure to understand what's there
51
- 4. Offer to help migrate:
52
- - If it has README files or markdown docs → propose creating a `flow.json` that maps them as steps
53
- - If it has a different workflow format → propose conversion
54
- - If it's missing key parts → guide user to fill them in
55
- 5. Create the missing `flow.json` manifest and step structure
56
- 6. Retry `flow_add` with the fixed source
57
-
58
- ### Native flow.json Format Reference
59
- ```json
60
- {
61
- "name": "my-flow",
62
- "version": "1.0.0",
63
- "description": "Description of the flow",
64
- "steps": [
65
- {
66
- "id": "step-id",
67
- "name": "Step Name",
68
- "instruction": "steps/step-id/README.md",
69
- "produces": ["output.md"],
70
- "requires": [],
71
- "agents": [],
72
- "description": "What this step does"
73
- }
74
- ],
75
- "agents": [],
76
- "artifacts_dir": ".spec",
77
- "install": []
78
- }
79
- ```
80
-
81
- ### Post-Install
82
- After successful installation:
83
- - Show the flow name, steps, and description via `present`
84
- - Remind user they can start it with `flow_start`
@@ -1,80 +0,0 @@
1
- ---
2
- description: "Create a new flow from scratch or migrate an existing workflow to aikit format"
3
- agent: "Orchestrator"
4
- ---
5
-
6
- ## Flow Creation Assistant
7
-
8
- Create a new development flow or migrate an existing workflow to the aikit flow format.
9
-
10
- ### Mode 1: Create from Scratch
11
-
12
- Guide the user through building a complete flow:
13
-
14
- 1. **Define the workflow** — Ask what the flow should accomplish (e.g., "TDD workflow", "documentation pipeline", "migration process")
15
- 2. **Design steps** — Break the workflow into sequential steps (3-8 is ideal)
16
- 3. **For each step**:
17
- - Define the step id, name, and description
18
- - Write the instruction (README.md content — what the agent should do)
19
- - Identify what it produces (output artifacts)
20
- - Identify what it requires (which previous steps must complete first)
21
- - Optionally assign preferred agents
22
- 4. **Generate flow.json** — Create the manifest with all steps
23
- 5. **Write step READMEs** — Create instruction files for each step
24
- 6. **Install** — Use `flow_add` to install from the local directory
25
-
26
- ### Mode 2: Migrate Existing Workflow
27
-
28
- If the user has an existing workflow (scripts, docs, runbooks) that they want to convert:
29
-
30
- 1. **Analyze the source** — Read the existing workflow files to understand the process
31
- 2. **Map to steps** — Identify discrete steps with clear inputs/outputs
32
- 3. **Identify gaps** — What's missing for a complete flow? (instructions? ordering? agents?)
33
- 4. **Fill gaps with user** — Ask user to clarify any ambiguous parts
34
- 5. **Generate the flow** — Create flow.json + step READMEs
35
- 6. **Install and validate** — Use `flow_add` and `flow_info` to verify
36
-
37
- ### Flow Structure
38
-
39
- ```
40
- my-flow/
41
- flow.json — Flow manifest (name, version, steps, agents)
42
- steps/
43
- step-1/
44
- README.md — Step instructions (what the agent should do)
45
- step-2/
46
- README.md
47
- references/ — Optional reference files for the step
48
- ...
49
- ```
50
-
51
- ### flow.json Format
52
- ```json
53
- {
54
- "name": "my-flow",
55
- "version": "1.0.0",
56
- "description": "What this flow does",
57
- "steps": [
58
- {
59
- "id": "step-id",
60
- "name": "Human-readable Step Name",
61
- "instruction": "steps/step-id/README.md",
62
- "produces": ["artifact-name.md"],
63
- "requires": [],
64
- "agents": ["Preferred-Agent"],
65
- "description": "Brief description of this step"
66
- }
67
- ],
68
- "agents": [],
69
- "artifacts_dir": ".spec",
70
- "install": []
71
- }
72
- ```
73
-
74
- ### Step README Format
75
- Each step README should include:
76
- - **Goal** — What this step accomplishes
77
- - **Inputs** — What context/artifacts from prior steps are needed
78
- - **Instructions** — Detailed steps for the agent to follow
79
- - **Output** — What artifact(s) to produce and where to save them
80
- - **Acceptance criteria** — How to know the step is complete
@@ -1,24 +0,0 @@
1
- ---
2
- description: "List, inspect, update, and remove installed flows"
3
- agent: "Orchestrator"
4
- ---
5
-
6
- ## Flow Management
7
-
8
- Manage your installed development flows.
9
-
10
- ### Available Actions
11
-
12
- 1. **List flows** — `flow_list` to see all installed flows with status
13
- 2. **Inspect a flow** — `flow_info` to see detailed steps, agents, and artifacts
14
- 3. **Check status** — `flow_status` to see the active flow and current step
15
- 4. **Update a flow** — `flow_update` to pull latest changes for git-installed flows
16
- 5. **Remove a flow** — `flow_remove` to uninstall (builtin flows cannot be removed)
17
- 6. **Start a flow** — `flow_start` to begin executing a flow
18
- 7. **Reset active flow** — `flow_reset` to clear active flow state
19
-
20
- ### Workflow
21
- 1. If no specific action requested, start with `flow_list` and present overview
22
- 2. Use `present` to display flow information in a clear table/card format
23
- 3. For updates, warn if there's an active flow that might be affected
24
- 4. For removals, confirm with user before proceeding
@@ -1,17 +0,0 @@
1
- ---
2
- description: "Full lifecycle implementation: plan → build → review → commit"
3
- agent: "Orchestrator"
4
- ---
5
-
6
- ## Implementation Pipeline
7
-
8
- Follow the Orchestrator's full workflow:
9
-
10
- 1. **Phase 0: Design Gate** — Orchestrator checks if design is needed. Creative/additive work triggers brainstorming first. Use `/design` if you want to start with design explicitly.
11
- 2. **Phase 1: Planning** — Research, draft plan, present to user for approval
12
- 3. **Phase 2: Implementation** — Execute phases in parallel batches
13
- 4. **Phase 3: Completion** — Final review, docs, persist learnings
14
-
15
- **🛑 MANDATORY STOPS** — After plan, after each batch, after completion.
16
-
17
- Refer to the Orchestrator agent's full instructions for the detailed workflow.
@@ -1,15 +0,0 @@
1
- ---
2
- description: "Create a detailed TDD implementation plan without executing it"
3
- agent: "Planner"
4
- ---
5
-
6
- ## Planning Workflow
7
-
8
- 1. **AI Kit Recall** — Search for past plans, architecture decisions
9
- 2. **FORGE Ground** — Classify tier, scope map, seed unknowns
10
- 3. **Research** — Explore codebase, understand subsystems
11
- 4. **Draft Plan** — 3-10 phases with agent assignments, TDD steps
12
- 5. **Dependency Graph** — Group into parallel batches
13
- 6. **Present** — Show plan with open questions
14
-
15
- **🛑 MANDATORY STOP** — Wait for user approval. Do NOT implement.
@@ -1,24 +0,0 @@
1
- ---
2
- description: "Dual-model code + architecture review pipeline"
3
- agent: "Orchestrator"
4
- ---
5
-
6
- ## Review Pipeline
7
-
8
- ### Step 1: Scope
9
- Identify changed files and their blast radius.
10
-
11
- ### Step 2: Code Review (parallel)
12
- Launch Code-Reviewer-Alpha and Code-Reviewer-Beta on the same changeset.
13
-
14
- ### Step 3: Architecture Review (if needed)
15
- If changes cross service boundaries or modify interfaces, launch Architect-Reviewer-Alpha and Architect-Reviewer-Beta.
16
-
17
- ### Step 4: Synthesis
18
- Merge findings from both reviewers:
19
- - **Agreements**: Both found same issue → HIGH confidence
20
- - **Unique findings**: One found, other didn't → verify
21
- - **Disagreements**: Contradicting verdicts → present both to user
22
-
23
- ### Step 5: Report
24
- Present unified review with: verdict, findings by severity, recommended actions.