@vpxa/aikit 0.1.74 → 0.1.76
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.
- package/package.json +5 -1
- package/packages/cli/dist/index.js +2 -2
- package/packages/cli/dist/{init-DQkar6Es.js → init-CuRXmyD9.js} +1 -1
- package/packages/cli/dist/scaffold-WMQ2uQ48.js +2 -0
- package/packages/cli/dist/{user-CopNWxHP.js → user-vbJwa7x2.js} +1 -1
- package/scaffold/dist/adapters/claude-code.mjs +4 -0
- package/scaffold/dist/adapters/copilot.mjs +75 -0
- package/scaffold/dist/adapters/flows.mjs +1 -0
- package/scaffold/dist/adapters/skills.mjs +1 -0
- package/scaffold/{compiled → dist/compiled}/flows-data.mjs +304 -446
- package/scaffold/{compiled → dist/compiled}/skills-data.mjs +554 -2281
- package/scaffold/dist/definitions/agents.mjs +9 -0
- package/scaffold/dist/definitions/bodies.mjs +512 -0
- package/scaffold/dist/definitions/exclusions.mjs +1 -0
- package/scaffold/dist/definitions/hooks.mjs +1 -0
- package/scaffold/dist/definitions/models.mjs +1 -0
- package/scaffold/dist/definitions/plugins.mjs +1 -0
- package/scaffold/dist/definitions/prompts.mjs +225 -0
- package/scaffold/dist/definitions/protocols.mjs +835 -0
- package/scaffold/dist/definitions/tools.mjs +1 -0
- package/packages/cli/dist/scaffold-ukCDW3wQ.js +0 -2
- package/scaffold/_preview/agents/Architect-Reviewer-Alpha.agent.md +0 -132
- package/scaffold/_preview/agents/Architect-Reviewer-Beta.agent.md +0 -132
- package/scaffold/_preview/agents/Code-Reviewer-Alpha.agent.md +0 -112
- package/scaffold/_preview/agents/Code-Reviewer-Beta.agent.md +0 -112
- package/scaffold/_preview/agents/Debugger.agent.md +0 -412
- package/scaffold/_preview/agents/Documenter.agent.md +0 -468
- package/scaffold/_preview/agents/Explorer.agent.md +0 -76
- package/scaffold/_preview/agents/Frontend.agent.md +0 -440
- package/scaffold/_preview/agents/Implementer.agent.md +0 -425
- package/scaffold/_preview/agents/Orchestrator.agent.md +0 -452
- package/scaffold/_preview/agents/Planner.agent.md +0 -481
- package/scaffold/_preview/agents/README.md +0 -57
- package/scaffold/_preview/agents/Refactor.agent.md +0 -435
- package/scaffold/_preview/agents/Researcher-Alpha.agent.md +0 -151
- package/scaffold/_preview/agents/Researcher-Beta.agent.md +0 -152
- package/scaffold/_preview/agents/Researcher-Delta.agent.md +0 -153
- package/scaffold/_preview/agents/Researcher-Gamma.agent.md +0 -152
- package/scaffold/_preview/agents/Security.agent.md +0 -433
- package/scaffold/_preview/agents/_shared/architect-reviewer-base.md +0 -104
- package/scaffold/_preview/agents/_shared/code-agent-base.md +0 -366
- package/scaffold/_preview/agents/_shared/code-reviewer-base.md +0 -87
- package/scaffold/_preview/agents/_shared/decision-protocol.md +0 -27
- package/scaffold/_preview/agents/_shared/forge-protocol.md +0 -90
- package/scaffold/_preview/agents/_shared/researcher-base.md +0 -114
- package/scaffold/_preview/agents/templates/adr-template.md +0 -28
- package/scaffold/_preview/agents/templates/execution-state.md +0 -26
- package/scaffold/_preview/flows/_epilogue/steps/docs-sync/README.md +0 -120
- package/scaffold/_preview/flows/aikit-advanced/README.md +0 -70
- package/scaffold/_preview/flows/aikit-advanced/steps/design/README.md +0 -178
- package/scaffold/_preview/flows/aikit-advanced/steps/execute/README.md +0 -145
- package/scaffold/_preview/flows/aikit-advanced/steps/plan/README.md +0 -122
- package/scaffold/_preview/flows/aikit-advanced/steps/spec/README.md +0 -121
- package/scaffold/_preview/flows/aikit-advanced/steps/task/README.md +0 -119
- package/scaffold/_preview/flows/aikit-advanced/steps/verify/README.md +0 -145
- package/scaffold/_preview/flows/aikit-basic/README.md +0 -51
- package/scaffold/_preview/flows/aikit-basic/steps/assess/README.md +0 -109
- package/scaffold/_preview/flows/aikit-basic/steps/design/README.md +0 -116
- package/scaffold/_preview/flows/aikit-basic/steps/implement/README.md +0 -131
- package/scaffold/_preview/flows/aikit-basic/steps/verify/README.md +0 -123
- package/scaffold/_preview/prompts/aikit-ask.prompt.md +0 -13
- package/scaffold/_preview/prompts/aikit-debug.prompt.md +0 -15
- package/scaffold/_preview/prompts/aikit-design.prompt.md +0 -15
- package/scaffold/_preview/prompts/aikit-flow-add.prompt.md +0 -84
- package/scaffold/_preview/prompts/aikit-flow-create.prompt.md +0 -80
- package/scaffold/_preview/prompts/aikit-flow-manage.prompt.md +0 -24
- package/scaffold/_preview/prompts/aikit-implement.prompt.md +0 -17
- package/scaffold/_preview/prompts/aikit-plan.prompt.md +0 -15
- package/scaffold/_preview/prompts/aikit-review.prompt.md +0 -24
- package/scaffold/_preview/skills/adr-skill/SKILL.md +0 -335
- package/scaffold/_preview/skills/adr-skill/assets/templates/adr-madr.md +0 -89
- package/scaffold/_preview/skills/adr-skill/assets/templates/adr-readme.md +0 -20
- package/scaffold/_preview/skills/adr-skill/assets/templates/adr-simple.md +0 -46
- package/scaffold/_preview/skills/adr-skill/references/adr-conventions.md +0 -95
- package/scaffold/_preview/skills/adr-skill/references/examples.md +0 -193
- package/scaffold/_preview/skills/adr-skill/references/review-checklist.md +0 -77
- package/scaffold/_preview/skills/adr-skill/references/template-variants.md +0 -52
- package/scaffold/_preview/skills/adr-skill/scripts/bootstrap_adr.js +0 -259
- package/scaffold/_preview/skills/adr-skill/scripts/new_adr.js +0 -391
- package/scaffold/_preview/skills/adr-skill/scripts/set_adr_status.js +0 -169
- package/scaffold/_preview/skills/aikit/SKILL.md +0 -754
- package/scaffold/_preview/skills/brainstorming/SKILL.md +0 -265
- package/scaffold/_preview/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
- package/scaffold/_preview/skills/c4-architecture/SKILL.md +0 -389
- package/scaffold/_preview/skills/c4-architecture/references/advanced-patterns.md +0 -552
- package/scaffold/_preview/skills/c4-architecture/references/c4-syntax.md +0 -510
- package/scaffold/_preview/skills/c4-architecture/references/common-mistakes.md +0 -437
- package/scaffold/_preview/skills/c4-architecture/references/html-design-system.md +0 -337
- package/scaffold/_preview/skills/c4-architecture/references/html-template.html +0 -627
- package/scaffold/_preview/skills/docs/SKILL.md +0 -553
- package/scaffold/_preview/skills/docs/references/diataxis-anti-patterns.md +0 -147
- package/scaffold/_preview/skills/docs/references/diataxis-compass.md +0 -123
- package/scaffold/_preview/skills/docs/references/diataxis-quadrants.md +0 -192
- package/scaffold/_preview/skills/docs/references/diataxis-quality.md +0 -76
- package/scaffold/_preview/skills/docs/references/diataxis-templates.md +0 -120
- package/scaffold/_preview/skills/docs/references/flow-artifacts-guide.md +0 -70
- package/scaffold/_preview/skills/docs/references/project-knowledge-gotchas.md +0 -32
- package/scaffold/_preview/skills/docs/references/project-knowledge-templates.md +0 -281
- package/scaffold/_preview/skills/docs/references/project-knowledge-workflow.md +0 -80
- package/scaffold/_preview/skills/frontend-design/SKILL.md +0 -237
- package/scaffold/_preview/skills/lesson-learned/SKILL.md +0 -113
- package/scaffold/_preview/skills/lesson-learned/references/anti-patterns.md +0 -55
- package/scaffold/_preview/skills/lesson-learned/references/se-principles.md +0 -109
- package/scaffold/_preview/skills/multi-agents-development/SKILL.md +0 -448
- package/scaffold/_preview/skills/multi-agents-development/architecture-review-prompt.md +0 -81
- package/scaffold/_preview/skills/multi-agents-development/code-quality-review-prompt.md +0 -91
- package/scaffold/_preview/skills/multi-agents-development/implementer-prompt.md +0 -93
- package/scaffold/_preview/skills/multi-agents-development/parallel-dispatch-example.md +0 -167
- package/scaffold/_preview/skills/multi-agents-development/spec-review-prompt.md +0 -81
- package/scaffold/_preview/skills/present/SKILL.md +0 -616
- package/scaffold/_preview/skills/react/SKILL.md +0 -309
- package/scaffold/_preview/skills/repo-access/SKILL.md +0 -178
- package/scaffold/_preview/skills/repo-access/references/error-patterns.md +0 -116
- package/scaffold/_preview/skills/repo-access/references/platform-matrix.md +0 -142
- package/scaffold/_preview/skills/requirements-clarity/SKILL.md +0 -333
- package/scaffold/_preview/skills/session-handoff/SKILL.md +0 -199
- package/scaffold/_preview/skills/session-handoff/references/handoff-template.md +0 -139
- package/scaffold/_preview/skills/session-handoff/references/resume-checklist.md +0 -80
- package/scaffold/_preview/skills/session-handoff/scripts/check_staleness.js +0 -269
- package/scaffold/_preview/skills/session-handoff/scripts/create_handoff.js +0 -299
- package/scaffold/_preview/skills/session-handoff/scripts/list_handoffs.js +0 -113
- package/scaffold/_preview/skills/session-handoff/scripts/validate_handoff.js +0 -241
- package/scaffold/_preview/skills/typescript/SKILL.md +0 -405
- package/scaffold/adapters/claude-code.mjs +0 -73
- package/scaffold/adapters/copilot.mjs +0 -292
- package/scaffold/adapters/flows.mjs +0 -27
- package/scaffold/adapters/skills.mjs +0 -25
- 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.
|