mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-05 16:13:08 +08:00
feat: add dynamic pipeline detection for team sessions v5 architecture
Backend:
- Fix readLegacyFiles to handle { name, prefix }[] role format
- Add roles backfill in getEffectiveTeamMeta when meta.json exists
- Ensure pipeline_stages and roles flow correctly to API response
Team Skills:
- Add pipeline metadata initialization to all 16 team skill coordinator roles
- Each skill now reports pipeline_stages and roles to meta.json at session init
Documentation:
- Update command references and component documentation
- Add numerical-analysis-workflow skill spec
- Sync zh/en translations for commands and components
This commit is contained in:
catlog22
@@ -186,13 +186,25 @@ Bash("mkdir -p .workflow/<session-id>/artifacts/pipelines/A .workflow/<session-i
|
|||||||
- `independent_targets`: populated for independent mode (e.g., ["refactor auth", "refactor API"])
|
- `independent_targets`: populated for independent mode (e.g., ["refactor auth", "refactor API"])
|
||||||
- `fix_cycles`: populated per-branch/pipeline as fix cycles occur
|
- `fix_cycles`: populated per-branch/pipeline as fix cycles occur
|
||||||
|
|
||||||
3. Initialize .msg/meta.json:
|
4. Initialize meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
```
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
Write("<session>/wisdom/.msg/meta.json", { "session_id": "<session-id>", "requirement": "<requirement>", "parallel_mode": "<mode>" })
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<parallel_mode>",
|
||||||
|
pipeline_stages: ["analyzer", "designer", "refactorer", "validator", "reviewer"],
|
||||||
|
roles: ["coordinator", "analyzer", "designer", "refactorer", "validator", "reviewer"],
|
||||||
|
team_name: "arch-opt"
|
||||||
|
}
|
||||||
|
})
|
||||||
```
|
```
|
||||||
|
|
||||||
4. Create team:
|
5. Create team:
|
||||||
|
|
||||||
```
|
```
|
||||||
TeamCreate({ team_name: "arch-opt" })
|
TeamCreate({ team_name: "arch-opt" })
|
||||||
|
|||||||
@@ -186,22 +186,26 @@ Bash("mkdir -p .workflow/.team/<session-id>/ideas .workflow/.team/<session-id>/c
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
4. Initialize .msg/meta.json:
|
4. Initialize meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
```json
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
{
|
mcp__ccw-tools__team_msg({
|
||||||
"session_id": "<session-id>",
|
operation: "log",
|
||||||
"team_name": "brainstorm",
|
session_id: "<session-id>",
|
||||||
"topic": "<topic>",
|
from: "coordinator",
|
||||||
"pipeline": "<mode>",
|
type: "state_update",
|
||||||
"angles": [],
|
summary: "Session initialized",
|
||||||
"gc_round": 0,
|
data: {
|
||||||
"generated_ideas": [],
|
pipeline_mode: "<mode>",
|
||||||
"critique_insights": [],
|
pipeline_stages: ["ideator", "challenger", "synthesizer", "evaluator"],
|
||||||
"synthesis_themes": [],
|
roles: ["coordinator", "ideator", "challenger", "synthesizer", "evaluator"],
|
||||||
"evaluation_scores": [],
|
team_name: "brainstorm",
|
||||||
"status": "active"
|
topic: "<topic>",
|
||||||
}
|
angles: ["<angle1>", "<angle2>"],
|
||||||
|
gc_round": 0,
|
||||||
|
status: "active"
|
||||||
|
}
|
||||||
|
})
|
||||||
```
|
```
|
||||||
|
|
||||||
5. Create team:
|
5. Create team:
|
||||||
|
|||||||
@@ -200,8 +200,24 @@ Regardless of complexity score or role count, coordinator MUST:
|
|||||||
- `explorations/cache-index.json` (`{ "entries": [] }`)
|
- `explorations/cache-index.json` (`{ "entries": [] }`)
|
||||||
- `discussions/` (empty directory)
|
- `discussions/` (empty directory)
|
||||||
|
|
||||||
9. **Initialize cross-role state** via team_msg:
|
9. **Initialize pipeline metadata** via team_msg:
|
||||||
- `team_msg(operation="log", session_id=<session-id>, from="coordinator", type="state_update", data={})`
|
```typescript
|
||||||
|
// 使用 team_msg 将 pipeline 元数据写入 .msg/meta.json
|
||||||
|
// 注意: 此处为动态角色，执行时需将 <placeholders> 替换为 task-analysis.json 中生成的实际角色列表
|
||||||
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<mode>",
|
||||||
|
pipeline_stages: ["<role1>", "<role2>", "<...dynamic-roles>"],
|
||||||
|
roles: ["coordinator", "<role1>", "<role2>", "<...dynamic-roles>"],
|
||||||
|
team_name: "<team-name>" // 从 session ID 或任务描述中提取
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
10. **Write team-session.json** with: session_id, task_description, status="active", roles, pipeline (empty), active_workers=[], completion_action="interactive", created_at
|
10. **Write team-session.json** with: session_id, task_description, status="active", roles, pipeline (empty), active_workers=[], completion_action="interactive", created_at
|
||||||
|
|
||||||
|
|||||||
@@ -161,10 +161,22 @@ Bash("mkdir -p .workflow/.team/FE-<slug>-<YYYY-MM-DD>/{.msg,wisdom,analysis,arch
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Initialize .msg/meta.json:
|
3. Initialize meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
```
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
Write("<session>/.msg/meta.json", { "session_id": "<session-id>", "requirement": "<requirement>", "pipeline_mode": "<mode>" })
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<page|feature|system>",
|
||||||
|
pipeline_stages: ["analyst", "architect", "developer", "qa"],
|
||||||
|
roles: ["coordinator", "analyst", "architect", "developer", "qa"],
|
||||||
|
team_name: "frontend"
|
||||||
|
}
|
||||||
|
})
|
||||||
```
|
```
|
||||||
|
|
||||||
4. Create team:
|
4. Create team:
|
||||||
|
|||||||
@@ -160,21 +160,22 @@ Bash("ccw issue list --status registered,pending --json")
|
|||||||
Bash("mkdir -p .workflow/.team-plan/issue/explorations .workflow/.team-plan/issue/solutions .workflow/.team-plan/issue/audits .workflow/.team-plan/issue/queue .workflow/.team-plan/issue/builds .workflow/.team-plan/issue/wisdom")
|
Bash("mkdir -p .workflow/.team-plan/issue/explorations .workflow/.team-plan/issue/solutions .workflow/.team-plan/issue/audits .workflow/.team-plan/issue/queue .workflow/.team-plan/issue/builds .workflow/.team-plan/issue/wisdom")
|
||||||
```
|
```
|
||||||
|
|
||||||
2. Write session state to `.msg/meta.json`:
|
2. Initialize meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
```json
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
{
|
mcp__ccw-tools__team_msg({
|
||||||
"session_id": "<session-id>",
|
operation: "log",
|
||||||
"status": "active",
|
session_id: "<session-id>",
|
||||||
"team_name": "issue",
|
from: "coordinator",
|
||||||
"mode": "<quick|full|batch>",
|
type: "state_update",
|
||||||
"issue_ids": [],
|
summary: "Session initialized",
|
||||||
"requirement": "<requirement>",
|
data: {
|
||||||
"execution_method": "<method>",
|
pipeline_mode: "<quick|full|batch>",
|
||||||
"code_review": "<setting>",
|
pipeline_stages: ["explorer", "planner", "reviewer", "integrator", "implementer"],
|
||||||
"timestamp": "<ISO-8601>",
|
roles: ["coordinator", "explorer", "planner", "reviewer", "integrator", "implementer"],
|
||||||
"fix_cycles": {}
|
team_name: "issue"
|
||||||
}
|
}
|
||||||
|
})
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Initialize wisdom directory (learnings.md, decisions.md, conventions.md, issues.md)
|
3. Initialize wisdom directory (learnings.md, decisions.md, conventions.md, issues.md)
|
||||||
|
|||||||
@@ -162,20 +162,22 @@ Bash("mkdir -p .workflow/.team/<session-id>/design .workflow/.team/<session-id>/
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
7. Initialize .msg/meta.json:
|
7. Initialize meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
```json
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
{
|
mcp__ccw-tools__team_msg({
|
||||||
"session_id": "<session-id>",
|
operation: "log",
|
||||||
"requirement": "<requirement>",
|
session_id: "<session-id>",
|
||||||
"pipeline": "<pipeline>",
|
from: "coordinator",
|
||||||
"architecture_decisions": [],
|
type: "state_update",
|
||||||
"implementation_context": [],
|
summary: "Session initialized",
|
||||||
"review_feedback_trends": [],
|
data: {
|
||||||
"gc_round": 0,
|
pipeline_mode: "<patch|sprint|multi-sprint>",
|
||||||
"max_gc_rounds": 3,
|
pipeline_stages: ["architect", "developer", "tester", "reviewer"],
|
||||||
"sprint_history": []
|
roles: ["coordinator", "architect", "developer", "tester", "reviewer"],
|
||||||
}
|
team_name: "iterdev"
|
||||||
|
}
|
||||||
|
})
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
@@ -127,17 +127,37 @@ For callback/check/resume: load `commands/monitor.md` and execute the appropriat
|
|||||||
4. Initialize wisdom directory (learnings.md, decisions.md, conventions.md, issues.md)
|
4. Initialize wisdom directory (learnings.md, decisions.md, conventions.md, issues.md)
|
||||||
5. Initialize explorations directory with empty cache-index.json
|
5. Initialize explorations directory with empty cache-index.json
|
||||||
6. Write team-session.json
|
6. Write team-session.json
|
||||||
|
7. **Initialize meta.json with pipeline metadata** (CRITICAL for UI):
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<mode>", // e.g., "full", "spec-only", "impl-only"
|
||||||
|
pipeline_stages: ["analyst", "writer", "planner", "executor", "tester", "reviewer"], // Roles as stages
|
||||||
|
roles: ["coordinator", "analyst", "writer", "planner", "executor", "tester", "reviewer"],
|
||||||
|
team_name: "lifecycle" // Skill name for badge display
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
**pipeline_stages format**: Array of role names that represent pipeline stages. The UI will display these as the pipeline workflow.
|
||||||
|
|
||||||
**Task counts by mode**:
|
**Task counts by mode**:
|
||||||
|
|
||||||
| Mode | Tasks |
|
| Mode | Tasks | pipeline_stages |
|
||||||
|------|-------|
|
|------|-------|-----------------|
|
||||||
| spec-only | 6 |
|
| spec-only | 6 | `["analyst", "writer", "reviewer"]` |
|
||||||
| impl-only | 4 |
|
| impl-only | 4 | `["planner", "executor", "tester", "reviewer"]` |
|
||||||
| fe-only | 3 |
|
| fe-only | 3 | `["planner", "fe-developer", "fe-qa"]` |
|
||||||
| fullstack | 6 |
|
| fullstack | 6 | `["planner", "executor", "fe-developer", "tester", "fe-qa", "reviewer"]` |
|
||||||
| full-lifecycle | 10 |
|
| full-lifecycle | 10 | `["analyst", "writer", "planner", "executor", "tester", "reviewer"]` |
|
||||||
| full-lifecycle-fe | 12 |
|
| full-lifecycle-fe | 12 | `["analyst", "writer", "planner", "executor", "fe-developer", "tester", "fe-qa", "reviewer"]` |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -186,10 +186,22 @@ Bash("mkdir -p .workflow/<session-id>/artifacts/pipelines/A .workflow/<session-i
|
|||||||
- `independent_targets`: populated for independent mode (e.g., ["optimize rendering", "optimize API"])
|
- `independent_targets`: populated for independent mode (e.g., ["optimize rendering", "optimize API"])
|
||||||
- `fix_cycles`: populated per-branch/pipeline as fix cycles occur
|
- `fix_cycles`: populated per-branch/pipeline as fix cycles occur
|
||||||
|
|
||||||
3. Initialize .msg/meta.json:
|
3. Initialize meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
```
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
Write("<session>/.msg/meta.json", { "session_id": "<session-id>", "requirement": "<requirement>", "parallel_mode": "<mode>" })
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<auto|single|fan-out|independent>",
|
||||||
|
pipeline_stages: ["profiler", "strategist", "optimizer", "benchmarker", "reviewer"],
|
||||||
|
roles: ["coordinator", "profiler", "strategist", "optimizer", "benchmarker", "reviewer"],
|
||||||
|
team_name: "perf-opt"
|
||||||
|
}
|
||||||
|
})
|
||||||
```
|
```
|
||||||
|
|
||||||
4. Create team:
|
4. Create team:
|
||||||
|
|||||||
@@ -95,18 +95,24 @@ For callback/check/resume: load `commands/monitor.md` and execute the appropriat
|
|||||||
3. Create subdirectories: `artifacts/solutions/`, `wisdom/`
|
3. Create subdirectories: `artifacts/solutions/`, `wisdom/`
|
||||||
4. Call `TeamCreate` with team name (default: "planex")
|
4. Call `TeamCreate` with team name (default: "planex")
|
||||||
5. Initialize wisdom files (learnings.md, decisions.md, conventions.md, issues.md)
|
5. Initialize wisdom files (learnings.md, decisions.md, conventions.md, issues.md)
|
||||||
6. Write .msg/meta.json:
|
6. Initialize meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
```
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
{
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
session_id: "<session-id>",
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "plan-execute",
|
||||||
|
pipeline_stages: ["planner", "executor"],
|
||||||
|
roles: ["coordinator", "planner", "executor"],
|
||||||
|
team_name: "planex",
|
||||||
input_type: "<issues|text|plan>",
|
input_type: "<issues|text|plan>",
|
||||||
input: "<raw-input>",
|
execution_method: "<agent|codex|gemini>"
|
||||||
execution_method: "<agent|codex|gemini>",
|
}
|
||||||
status: "active",
|
})
|
||||||
active_workers: [],
|
|
||||||
started_at: "<ISO timestamp>"
|
|
||||||
}
|
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
@@ -139,23 +139,34 @@ For callback/check/resume/complete: load `commands/monitor.md` and execute match
|
|||||||
1. Generate session ID
|
1. Generate session ID
|
||||||
2. Create session folder
|
2. Create session folder
|
||||||
3. Call TeamCreate with team name
|
3. Call TeamCreate with team name
|
||||||
4. Initialize .msg/meta.json with empty fields
|
4. Initialize meta.json with pipeline metadata and shared state:
|
||||||
|
```typescript
|
||||||
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<discovery|testing|full>",
|
||||||
|
pipeline_stages: ["scout", "strategist", "generator", "executor", "analyst"],
|
||||||
|
roles: ["coordinator", "scout", "strategist", "generator", "executor", "analyst"],
|
||||||
|
team_name: "quality-assurance",
|
||||||
|
discovered_issues: [],
|
||||||
|
test_strategy: {},
|
||||||
|
generated_tests: {},
|
||||||
|
execution_results: {},
|
||||||
|
defect_patterns: [],
|
||||||
|
coverage_history: [],
|
||||||
|
quality_score: null
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
5. Initialize wisdom directory (learnings.md, decisions.md, conventions.md, issues.md)
|
5. Initialize wisdom directory (learnings.md, decisions.md, conventions.md, issues.md)
|
||||||
6. Write session file with: session_id, mode, scope, status="active"
|
6. Write session file with: session_id, mode, scope, status="active"
|
||||||
|
|
||||||
**Shared Memory Structure**:
|
|
||||||
```
|
|
||||||
{
|
|
||||||
"discovered_issues": [],
|
|
||||||
"test_strategy": {},
|
|
||||||
"generated_tests": {},
|
|
||||||
"execution_results": {},
|
|
||||||
"defect_patterns": [],
|
|
||||||
"coverage_history": [],
|
|
||||||
"quality_score": null
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Success**: Team created, session file written, shared memory initialized.
|
**Success**: Team created, session file written, shared memory initialized.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
@@ -197,7 +197,26 @@ Bash("ccw team log --session-id <session-id> --from coordinator --type dispatch_
|
|||||||
│ └── meta.json
|
│ └── meta.json
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Initialize .msg/meta.json with: workflow_id, mode, target, dimensions, auto flag
|
3. Initialize .msg/meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<default|full|fix-only|quick>",
|
||||||
|
pipeline_stages: ["scanner", "reviewer", "fixer"],
|
||||||
|
roles: ["coordinator", "scanner", "reviewer", "fixer"],
|
||||||
|
team_name: "review",
|
||||||
|
target: "<target>",
|
||||||
|
dimensions: "<dimensions>",
|
||||||
|
auto_confirm: "<auto_confirm>"
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
**Success**: Session folder created, shared memory initialized.
|
**Success**: Session folder created, shared memory initialized.
|
||||||
|
|
||||||
|
|||||||
@@ -198,8 +198,27 @@ Delegate to `commands/roadmap-discuss.md`:
|
|||||||
**Workflow**:
|
**Workflow**:
|
||||||
|
|
||||||
1. Call `TeamCreate({ team_name: "roadmap-dev" })`
|
1. Call `TeamCreate({ team_name: "roadmap-dev" })`
|
||||||
2. Spawn worker roles (see SKILL.md Coordinator Spawn Template)
|
|
||||||
3. Load `commands/dispatch.md` for task chain creation
|
2. Initialize meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "roadmap-driven",
|
||||||
|
pipeline_stages: ["planner", "executor", "verifier"],
|
||||||
|
roles: ["coordinator", "planner", "executor", "verifier"],
|
||||||
|
team_name: "roadmap-dev"
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Spawn worker roles (see SKILL.md Coordinator Spawn Template)
|
||||||
|
4. Load `commands/dispatch.md` for task chain creation
|
||||||
|
|
||||||
| Step | Action |
|
| Step | Action |
|
||||||
|------|--------|
|
|------|--------|
|
||||||
|
|||||||
@@ -224,17 +224,30 @@ Bash("ccw team log --session-id <session-id> --from coordinator --type <message-
|
|||||||
└── issues.md
|
└── issues.md
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Initialize .msg/meta.json:
|
3. Initialize .msg/meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
| Field | Initial Value |
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
|-------|---------------|
|
mcp__ccw-tools__team_msg({
|
||||||
| `debt_inventory` | [] |
|
operation: "log",
|
||||||
| `priority_matrix` | {} |
|
session_id: "<session-id>",
|
||||||
| `remediation_plan` | {} |
|
from: "coordinator",
|
||||||
| `fix_results` | {} |
|
type: "state_update",
|
||||||
| `validation_results` | {} |
|
summary: "Session initialized",
|
||||||
| `debt_score_before` | null |
|
data: {
|
||||||
| `debt_score_after` | null |
|
pipeline_mode: "<scan|remediate|targeted>",
|
||||||
|
pipeline_stages: ["scanner", "assessor", "planner", "executor", "validator"],
|
||||||
|
roles: ["coordinator", "scanner", "assessor", "planner", "executor", "validator"],
|
||||||
|
team_name: "tech-debt",
|
||||||
|
debt_inventory: [],
|
||||||
|
priority_matrix: {},
|
||||||
|
remediation_plan: {},
|
||||||
|
fix_results: {},
|
||||||
|
validation_results: {},
|
||||||
|
debt_score_before: null,
|
||||||
|
debt_score_after: null
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
4. Call TeamCreate with team name "tech-debt"
|
4. Call TeamCreate with team name "tech-debt"
|
||||||
|
|
||||||
|
|||||||
@@ -157,10 +157,22 @@ Bash("mkdir -p .workflow/.team/TST-<slug>-<date>/strategy .workflow/.team/TST-<s
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Initialize .msg/meta.json:
|
3. Initialize .msg/meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
```
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
Write("<session>/wisdom/.msg/meta.json", { "session_id": "<session-id>", "requirement": "<requirement>", "pipeline": "<mode>" })
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<targeted|standard|comprehensive>",
|
||||||
|
pipeline_stages: ["strategist", "generator", "executor", "analyst"],
|
||||||
|
roles: ["coordinator", "strategist", "generator", "executor", "analyst"],
|
||||||
|
team_name: "testing"
|
||||||
|
}
|
||||||
|
})
|
||||||
```
|
```
|
||||||
|
|
||||||
4. Create team:
|
4. Create team:
|
||||||
|
|||||||
@@ -170,10 +170,22 @@ Bash("mkdir -p .workflow/.team/UDS-<slug>-<date>/research .workflow/.team/UDS-<s
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Initialize .msg/meta.json:
|
3. Initialize .msg/meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
```
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
Write("<session>/wisdom/.msg/meta.json", { "session_id": "<session-id>", "requirement": "<requirement>", "pipeline": "<pipeline>" })
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<component|system|full-system>",
|
||||||
|
pipeline_stages: ["researcher", "designer", "reviewer", "implementer"],
|
||||||
|
roles: ["coordinator", "researcher", "designer", "reviewer", "implementer"],
|
||||||
|
team_name: "uidesign"
|
||||||
|
}
|
||||||
|
})
|
||||||
```
|
```
|
||||||
|
|
||||||
4. Create team:
|
4. Create team:
|
||||||
|
|||||||
@@ -156,7 +156,24 @@ TeamCreate({ team_name: "ultra-analyze" })
|
|||||||
```
|
```
|
||||||
|
|
||||||
3. Write session.json with mode, requirement, timestamp
|
3. Write session.json with mode, requirement, timestamp
|
||||||
4. Initialize .msg/meta.json
|
4. Initialize .msg/meta.json with pipeline metadata:
|
||||||
|
```typescript
|
||||||
|
// Use team_msg to write pipeline metadata to .msg/meta.json
|
||||||
|
mcp__ccw-tools__team_msg({
|
||||||
|
operation: "log",
|
||||||
|
session_id: "<session-id>",
|
||||||
|
from: "coordinator",
|
||||||
|
type: "state_update",
|
||||||
|
summary: "Session initialized",
|
||||||
|
data: {
|
||||||
|
pipeline_mode: "<Quick|Deep|Standard>",
|
||||||
|
pipeline_stages: ["explorer", "analyst", "discussant", "synthesizer"],
|
||||||
|
roles: ["coordinator", "explorer", "analyst", "discussant", "synthesizer"],
|
||||||
|
team_name: "ultra-analyze"
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
5. Call `TeamCreate({ team_name: "ultra-analyze" })`
|
5. Call `TeamCreate({ team_name: "ultra-analyze" })`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
630
.codex/skills/numerical-analysis-workflow/SKILL.md
Normal file
630
.codex/skills/numerical-analysis-workflow/SKILL.md
Normal file
@@ -0,0 +1,630 @@
|
|||||||
|
---
|
||||||
|
name: numerical-analysis-workflow
|
||||||
|
description: Global-to-local numerical computation project analysis workflow. Decomposes analysis into 6-phase diamond topology (Global → Theory → Algorithm → Module → Local → Integration) with parallel analysis tracks per phase, cross-phase context propagation, and LaTeX formula support. Produces comprehensive analysis documents covering mathematical foundations, numerical stability, convergence, error bounds, and software architecture.
|
||||||
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"project path or description\""
|
||||||
|
allowed-tools: spawn_agents_on_csv, Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
## Auto Mode
|
||||||
|
|
||||||
|
When `--yes` or `-y`: Auto-confirm track decomposition, skip interactive validation, use defaults.
|
||||||
|
|
||||||
|
# Numerical Analysis Workflow
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$numerical-analysis-workflow "Analyze the FEM solver in src/solver/"
|
||||||
|
$numerical-analysis-workflow -c 3 "Analyze CFD simulation pipeline for numerical stability"
|
||||||
|
$numerical-analysis-workflow -y "Full analysis of PDE discretization in src/pde/"
|
||||||
|
$numerical-analysis-workflow --continue "nadw-fem-solver-20260304"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Flags**:
|
||||||
|
- `-y, --yes`: Skip all confirmations (auto mode)
|
||||||
|
- `-c, --concurrency N`: Max concurrent agents within each wave (default: 3)
|
||||||
|
- `--continue`: Resume existing session
|
||||||
|
|
||||||
|
**Output Directory**: `.workflow/.csv-wave/{session-id}/`
|
||||||
|
**Core Output**: `tasks.csv` (master state) + `results.csv` (final) + `discoveries.ndjson` (shared exploration) + `context.md` (human-readable report)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
Six-phase diamond topology for analyzing numerical computation software projects. Each phase represents a wave; within each wave, 2-5 parallel analysis tracks produce focused documents. Context packages propagate cumulatively between waves, enabling perspective reuse — theory informs algorithm design, algorithm informs implementation, all converge at integration.
|
||||||
|
|
||||||
|
**Core workflow**: Survey → Theorize → Design → Analyze Modules → Optimize Locally → Integrate & Validate
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────────────────────┐
|
||||||
|
│ NUMERICAL ANALYSIS DIAMOND WORKFLOW (NADW) │
|
||||||
|
├─────────────────────────────────────────────────────────────────────────┤
|
||||||
|
│ │
|
||||||
|
│ Wave 1: Global Survey [3 tracks] │
|
||||||
|
│ ├─ T1.1 Problem Domain Survey (math models, governing equations) │
|
||||||
|
│ ├─ T1.2 Software Architecture Overview (modules, data flow) │
|
||||||
|
│ └─ T1.3 Validation Strategy (benchmarks, KPIs, acceptance) │
|
||||||
|
│ ↓ Context Package P1 │
|
||||||
|
│ │
|
||||||
|
│ Wave 2: Theoretical Foundations [3 tracks] │
|
||||||
|
│ ├─ T2.1 Mathematical Formulation (LaTeX derivation, weak forms) │
|
||||||
|
│ ├─ T2.2 Convergence Analysis (error bounds, convergence order) │
|
||||||
|
│ └─ T2.3 Complexity Analysis (time/space Big-O, operation counts) │
|
||||||
|
│ ↓ Context Package P1+P2 │
|
||||||
|
│ │
|
||||||
|
│ Wave 3: Algorithm Design & Stability [3 tracks] │
|
||||||
|
│ ├─ T3.1 Algorithm Specification (method selection, pseudocode) │
|
||||||
|
│ ├─ T3.2 Numerical Stability Report (condition numbers, error prop) │
|
||||||
|
│ └─ T3.3 Performance Model (FLOPS, memory bandwidth, parallelism) │
|
||||||
|
│ ↓ Context Package P1+P2+P3 │
|
||||||
|
│ │
|
||||||
|
│ Wave 4: Module Implementation [3 tracks] │
|
||||||
|
│ ├─ T4.1 Core Module Analysis (algorithm-code mapping) │
|
||||||
|
│ ├─ T4.2 Data Structure Review (sparse formats, memory layout) │
|
||||||
|
│ └─ T4.3 API Contract Analysis (interfaces, error handling) │
|
||||||
|
│ ↓ Context Package P1-P4 │
|
||||||
|
│ │
|
||||||
|
│ Wave 5: Local Function-Level [3 tracks] │
|
||||||
|
│ ├─ T5.1 Optimization Report (hotspots, vectorization, cache) │
|
||||||
|
│ ├─ T5.2 Edge Case Analysis (singularities, overflow, degeneracy) │
|
||||||
|
│ └─ T5.3 Precision Audit (catastrophic cancellation, accumulation) │
|
||||||
|
│ ↓ Context Package P1-P5 │
|
||||||
|
│ │
|
||||||
|
│ Wave 6: Integration & QA [3 tracks] │
|
||||||
|
│ ├─ T6.1 Integration Test Plan (end-to-end, regression, benchmark) │
|
||||||
|
│ ├─ T6.2 Benchmark Results (actual vs theoretical performance) │
|
||||||
|
│ └─ T6.3 Final QA Report (all-phase synthesis, risk matrix, roadmap) │
|
||||||
|
│ │
|
||||||
|
└─────────────────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
**Diamond Topology** (Wide → Deep → Wide):
|
||||||
|
```
|
||||||
|
Wave 1: [T1.1] [T1.2] [T1.3] ← Global扇出
|
||||||
|
Wave 2: [T2.1] [T2.2] [T2.3] ← Theory深入
|
||||||
|
Wave 3: [T3.1] [T3.2] [T3.3] ← Algorithm桥接
|
||||||
|
Wave 4: [T4.1] [T4.2] [T4.3] ← Module聚焦
|
||||||
|
Wave 5: [T5.1] [T5.2] [T5.3] ← Local最细
|
||||||
|
Wave 6: [T6.1] [T6.2] [T6.3] ← Integration汇聚
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## CSV Schema
|
||||||
|
|
||||||
|
### tasks.csv (Master State)
|
||||||
|
|
||||||
|
```csv
|
||||||
|
id,title,description,track_role,analysis_dimension,formula_refs,precision_req,scope,deps,context_from,wave,status,findings,severity_distribution,latex_formulas,doc_path,error
|
||||||
|
"T1.1","Problem Domain Survey","Survey governing equations and mathematical models for the numerical computation project. Identify PDE types, boundary conditions, conservation laws.","Problem_Domain_Analyst","domain_modeling","","","src/**","","","1","","","","","",""
|
||||||
|
"T2.1","Mathematical Formulation","Derive precise mathematical formulations using LaTeX. Transform governing equations into weak forms suitable for discretization.","Mathematician","formula_derivation","T1.1:governing_eqs","","src/**","T1.1","T1.1","2","","","","","",""
|
||||||
|
"T3.1","Algorithm Specification","Select numerical methods and design algorithms based on theoretical analysis. Produce pseudocode for core computational kernels.","Algorithm_Designer","method_selection","T2.1:weak_forms;T2.2:convergence_conds","double","src/solver/**","T2.1","T2.1;T2.2;T2.3","3","","","","","",""
|
||||||
|
```
|
||||||
|
|
||||||
|
**Columns**:
|
||||||
|
|
||||||
|
| Column | Phase | Description |
|
||||||
|
|--------|-------|-------------|
|
||||||
|
| `id` | Input | Unique task identifier (T{wave}.{track}) |
|
||||||
|
| `title` | Input | Short task title |
|
||||||
|
| `description` | Input | Detailed task description (self-contained for agent) |
|
||||||
|
| `track_role` | Input | Analysis role name (e.g., Mathematician, Stability_Analyst) |
|
||||||
|
| `analysis_dimension` | Input | Analysis focus area (domain_modeling, formula_derivation, stability, etc.) |
|
||||||
|
| `formula_refs` | Input | Semicolon-separated references to formulas from earlier tasks (TaskID:formula_name) |
|
||||||
|
| `precision_req` | Input | Required floating-point precision (float/double/quad/adaptive) |
|
||||||
|
| `scope` | Input | File/directory scope for analysis (glob pattern) |
|
||||||
|
| `deps` | Input | Semicolon-separated dependency task IDs |
|
||||||
|
| `context_from` | Input | Semicolon-separated task IDs whose findings this task needs |
|
||||||
|
| `wave` | Computed | Wave number (1-6, from phase assignment) |
|
||||||
|
| `status` | Output | `pending` → `completed` / `failed` / `skipped` |
|
||||||
|
| `findings` | Output | Key discoveries and conclusions (max 500 chars) |
|
||||||
|
| `severity_distribution` | Output | Issue counts: Critical/High/Medium/Low |
|
||||||
|
| `latex_formulas` | Output | Key LaTeX formulas discovered or derived (semicolon-separated) |
|
||||||
|
| `doc_path` | Output | Path to generated analysis document |
|
||||||
|
| `error` | Output | Error message if failed |
|
||||||
|
|
||||||
|
### Per-Wave CSV (Temporary)
|
||||||
|
|
||||||
|
Each wave generates a temporary `wave-{N}.csv` with extra `prev_context` column.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output Artifacts
|
||||||
|
|
||||||
|
| File | Purpose | Lifecycle |
|
||||||
|
|------|---------|-----------|
|
||||||
|
| `tasks.csv` | Master state — all tasks with status/findings | Updated after each wave |
|
||||||
|
| `wave-{N}.csv` | Per-wave input (temporary) | Created before wave, deleted after |
|
||||||
|
| `results.csv` | Final export of all task results | Created in Phase 3 |
|
||||||
|
| `discoveries.ndjson` | Shared exploration board across all agents | Append-only, carries across waves |
|
||||||
|
| `context.md` | Human-readable execution report | Created in Phase 3 |
|
||||||
|
| `docs/P{N}_*.md` | Per-track analysis documents | Created by each agent |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Session Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
.workflow/.csv-wave/{session-id}/
|
||||||
|
├── tasks.csv # Master state (updated per wave)
|
||||||
|
├── results.csv # Final results export
|
||||||
|
├── discoveries.ndjson # Shared discovery board (all agents)
|
||||||
|
├── context.md # Human-readable report
|
||||||
|
├── docs/ # Analysis documents per track
|
||||||
|
│ ├── P1_Domain_Survey.md
|
||||||
|
│ ├── P1_Architecture_Overview.md
|
||||||
|
│ ├── P1_Validation_Strategy.md
|
||||||
|
│ ├── P2_Mathematical_Formulation.md
|
||||||
|
│ ├── P2_Convergence_Analysis.md
|
||||||
|
│ ├── P2_Complexity_Analysis.md
|
||||||
|
│ ├── P3_Algorithm_Specification.md
|
||||||
|
│ ├── P3_Numerical_Stability_Report.md
|
||||||
|
│ ├── P3_Performance_Model.md
|
||||||
|
│ ├── P4_Module_Implementation_Analysis.md
|
||||||
|
│ ├── P4_Data_Structure_Review.md
|
||||||
|
│ ├── P4_API_Contract.md
|
||||||
|
│ ├── P5_Optimization_Report.md
|
||||||
|
│ ├── P5_Edge_Case_Analysis.md
|
||||||
|
│ ├── P5_Precision_Audit.md
|
||||||
|
│ ├── P6_Integration_Test_Plan.md
|
||||||
|
│ ├── P6_Benchmark_Results.md
|
||||||
|
│ └── P6_Final_QA_Report.md
|
||||||
|
└── wave-{N}.csv # Temporary per-wave input (cleaned up)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Implementation
|
||||||
|
|
||||||
|
### Session Initialization
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const getUtc8ISOString = () => new Date(Date.now() + 8 * 60 * 60 * 1000).toISOString()
|
||||||
|
|
||||||
|
// Parse flags
|
||||||
|
const AUTO_YES = $ARGUMENTS.includes('--yes') || $ARGUMENTS.includes('-y')
|
||||||
|
const continueMode = $ARGUMENTS.includes('--continue')
|
||||||
|
const concurrencyMatch = $ARGUMENTS.match(/(?:--concurrency|-c)\s+(\d+)/)
|
||||||
|
const maxConcurrency = concurrencyMatch ? parseInt(concurrencyMatch[1]) : 3
|
||||||
|
|
||||||
|
// Clean requirement text
|
||||||
|
const requirement = $ARGUMENTS
|
||||||
|
.replace(/--yes|-y|--continue|--concurrency\s+\d+|-c\s+\d+/g, '')
|
||||||
|
.trim()
|
||||||
|
|
||||||
|
const slug = requirement.toLowerCase()
|
||||||
|
.replace(/[^a-z0-9\u4e00-\u9fa5]+/g, '-')
|
||||||
|
.substring(0, 40)
|
||||||
|
const dateStr = getUtc8ISOString().substring(0, 10).replace(/-/g, '')
|
||||||
|
const sessionId = `nadw-${slug}-${dateStr}`
|
||||||
|
const sessionFolder = `.workflow/.csv-wave/${sessionId}`
|
||||||
|
|
||||||
|
Bash(`mkdir -p ${sessionFolder}/docs`)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Phase 1: Requirement → CSV (Decomposition)
|
||||||
|
|
||||||
|
**Objective**: Analyze the target project/requirement, decompose into 18 analysis tasks (6 waves × 3 tracks), compute wave assignments, generate tasks.csv.
|
||||||
|
|
||||||
|
**Decomposition Rules**:
|
||||||
|
|
||||||
|
| Wave | Phase Name | Track Roles | Analysis Focus |
|
||||||
|
|------|-----------|-------------|----------------|
|
||||||
|
| 1 | Global Survey | Problem_Domain_Analyst, Software_Architect, Validation_Strategist | Mathematical models, architecture, validation strategy |
|
||||||
|
| 2 | Theoretical Foundations | Mathematician, Convergence_Analyst, Complexity_Analyst | Formula derivation, convergence proofs, complexity bounds |
|
||||||
|
| 3 | Algorithm Design | Algorithm_Designer, Stability_Analyst, Performance_Modeler | Method selection, numerical stability, performance prediction |
|
||||||
|
| 4 | Module Implementation | Module_Implementer, Data_Structure_Designer, Interface_Analyst | Code-algorithm mapping, data structures, API contracts |
|
||||||
|
| 5 | Local Function-Level | Code_Optimizer, Edge_Case_Analyst, Precision_Auditor | Hotspot optimization, boundary handling, float precision |
|
||||||
|
| 6 | Integration & QA | Integration_Tester, Benchmark_Engineer, QA_Auditor | End-to-end testing, benchmarks, final quality report |
|
||||||
|
|
||||||
|
**Dependency Structure** (Diamond Topology):
|
||||||
|
|
||||||
|
| Task | deps | context_from | Rationale |
|
||||||
|
|------|------|-------------|-----------|
|
||||||
|
| T1.* | (none) | (none) | Wave 1: independent, global survey |
|
||||||
|
| T2.1 | T1.1 | T1.1 | Formalization needs governing equations |
|
||||||
|
| T2.2 | T1.1 | T1.1 | Convergence analysis needs model identification |
|
||||||
|
| T2.3 | T1.1;T1.2 | T1.1;T1.2 | Complexity needs both model and architecture |
|
||||||
|
| T3.1 | T2.1 | T2.1;T2.2;T2.3 | Algorithm design needs all theory |
|
||||||
|
| T3.2 | T2.1;T2.2 | T2.1;T2.2 | Stability needs formulas and convergence |
|
||||||
|
| T3.3 | T2.3 | T1.2;T2.3 | Performance model needs architecture + complexity |
|
||||||
|
| T4.* | T3.* | T1.*;T3.* | Module analysis needs global + algorithm context |
|
||||||
|
| T5.* | T4.* | T3.*;T4.* | Local analysis needs algorithm + module context |
|
||||||
|
| T6.* | T5.* | T1.*;T2.*;T3.*;T4.*;T5.* | Integration receives ALL context |
|
||||||
|
|
||||||
|
**Decomposition CLI Call**:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
Bash({
|
||||||
|
command: `ccw cli -p "PURPOSE: Decompose numerical computation project analysis into 18 tasks across 6 phases.
|
||||||
|
TASK:
|
||||||
|
• Analyze the project to identify: governing equations, numerical methods used, module structure
|
||||||
|
• Generate 18 analysis tasks (3 per phase × 6 phases) following the NADW diamond topology
|
||||||
|
• Each task must be self-contained with clear scope and analysis dimension
|
||||||
|
• Assign track_role, analysis_dimension, formula_refs, precision_req, scope for each task
|
||||||
|
• Set deps and context_from following the diamond dependency pattern
|
||||||
|
MODE: analysis
|
||||||
|
CONTEXT: @**/*
|
||||||
|
EXPECTED: JSON with tasks array. Each task: {id, title, description, track_role, analysis_dimension, formula_refs, precision_req, scope, deps[], context_from[]}
|
||||||
|
CONSTRAINTS: Exactly 6 waves, 3 tasks per wave. Wave 1=Global, Wave 2=Theory, Wave 3=Algorithm, Wave 4=Module, Wave 5=Local, Wave 6=Integration.
|
||||||
|
|
||||||
|
PROJECT TO ANALYZE: ${requirement}" --tool gemini --mode analysis --rule planning-breakdown-task-steps`,
|
||||||
|
run_in_background: true
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
**Wave Computation**: Fixed 6-wave assignment per the diamond topology. Tasks within each wave are independent.
|
||||||
|
|
||||||
|
**CSV Generation**: Parse JSON response, validate 18 tasks with correct wave assignments, generate tasks.csv with proper escaping.
|
||||||
|
|
||||||
|
**User Validation**: Display task breakdown grouped by wave (skip if AUTO_YES):
|
||||||
|
|
||||||
|
```
|
||||||
|
Wave 1 (Global Survey):
|
||||||
|
T1.1 Problem Domain Survey → Problem_Domain_Analyst
|
||||||
|
T1.2 Software Architecture Overview → Software_Architect
|
||||||
|
T1.3 Validation Strategy → Validation_Strategist
|
||||||
|
|
||||||
|
Wave 2 (Theoretical Foundations):
|
||||||
|
T2.1 Mathematical Formulation → Mathematician
|
||||||
|
T2.2 Convergence Analysis → Convergence_Analyst
|
||||||
|
T2.3 Complexity Analysis → Complexity_Analyst
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
**Success Criteria**:
|
||||||
|
- tasks.csv created with 18 tasks, 6 waves, valid schema
|
||||||
|
- No circular dependencies
|
||||||
|
- Each task has track_role and analysis_dimension
|
||||||
|
- User approved (or AUTO_YES)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Phase 2: Wave Execution Engine
|
||||||
|
|
||||||
|
**Objective**: Execute analysis tasks wave-by-wave via spawn_agents_on_csv with cross-wave context propagation and cumulative context packages.
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
// Read master CSV
|
||||||
|
const masterCsv = Read(`${sessionFolder}/tasks.csv`)
|
||||||
|
const tasks = parseCsv(masterCsv)
|
||||||
|
const maxWave = 6
|
||||||
|
|
||||||
|
for (let wave = 1; wave <= maxWave; wave++) {
|
||||||
|
// 1. Filter tasks for this wave
|
||||||
|
const waveTasks = tasks.filter(t => t.wave === wave && t.status === 'pending')
|
||||||
|
|
||||||
|
// 2. Skip tasks whose deps failed/skipped
|
||||||
|
for (const task of waveTasks) {
|
||||||
|
const depIds = task.deps.split(';').filter(Boolean)
|
||||||
|
const depStatuses = depIds.map(id => tasks.find(t => t.id === id)?.status)
|
||||||
|
if (depStatuses.some(s => s === 'failed' || s === 'skipped')) {
|
||||||
|
task.status = 'skipped'
|
||||||
|
task.error = `Dependency failed: ${depIds.filter((id, i) => ['failed','skipped'].includes(depStatuses[i])).join(', ')}`
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const pendingTasks = waveTasks.filter(t => t.status === 'pending')
|
||||||
|
if (pendingTasks.length === 0) continue
|
||||||
|
|
||||||
|
// 3. Build prev_context from context_from + master CSV findings
|
||||||
|
for (const task of pendingTasks) {
|
||||||
|
const contextIds = task.context_from.split(';').filter(Boolean)
|
||||||
|
const prevFindings = contextIds.map(id => {
|
||||||
|
const src = tasks.find(t => t.id === id)
|
||||||
|
return src?.findings ? `[${src.id} ${src.title}]: ${src.findings}` : ''
|
||||||
|
}).filter(Boolean).join('\n\n')
|
||||||
|
|
||||||
|
// Also include latex_formulas from context sources
|
||||||
|
const prevFormulas = contextIds.map(id => {
|
||||||
|
const src = tasks.find(t => t.id === id)
|
||||||
|
return src?.latex_formulas ? `[${src.id} formulas]: ${src.latex_formulas}` : ''
|
||||||
|
}).filter(Boolean).join('\n')
|
||||||
|
|
||||||
|
task.prev_context = prevFindings + (prevFormulas ? '\n\n--- Referenced Formulas ---\n' + prevFormulas : '')
|
||||||
|
}
|
||||||
|
|
||||||
|
// 4. Write per-wave CSV
|
||||||
|
Write(`${sessionFolder}/wave-${wave}.csv`, toCsv(pendingTasks))
|
||||||
|
|
||||||
|
// 5. Execute wave
|
||||||
|
spawn_agents_on_csv({
|
||||||
|
csv_path: `${sessionFolder}/wave-${wave}.csv`,
|
||||||
|
id_column: "id",
|
||||||
|
instruction: buildInstructionTemplate(sessionFolder, wave),
|
||||||
|
max_concurrency: maxConcurrency,
|
||||||
|
max_runtime_seconds: 900,
|
||||||
|
output_csv_path: `${sessionFolder}/wave-${wave}-results.csv`,
|
||||||
|
output_schema: {
|
||||||
|
type: "object",
|
||||||
|
properties: {
|
||||||
|
id: { type: "string" },
|
||||||
|
status: { type: "string", enum: ["completed", "failed"] },
|
||||||
|
findings: { type: "string" },
|
||||||
|
severity_distribution: { type: "string" },
|
||||||
|
latex_formulas: { type: "string" },
|
||||||
|
doc_path: { type: "string" },
|
||||||
|
error: { type: "string" }
|
||||||
|
},
|
||||||
|
required: ["id", "status", "findings"]
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
// 6. Merge results into master CSV
|
||||||
|
const waveResults = parseCsv(Read(`${sessionFolder}/wave-${wave}-results.csv`))
|
||||||
|
for (const result of waveResults) {
|
||||||
|
const masterTask = tasks.find(t => t.id === result.id)
|
||||||
|
if (masterTask) {
|
||||||
|
masterTask.status = result.status
|
||||||
|
masterTask.findings = result.findings
|
||||||
|
masterTask.severity_distribution = result.severity_distribution || ''
|
||||||
|
masterTask.latex_formulas = result.latex_formulas || ''
|
||||||
|
masterTask.doc_path = result.doc_path || ''
|
||||||
|
masterTask.error = result.error || ''
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Write(`${sessionFolder}/tasks.csv`, toCsv(tasks))
|
||||||
|
|
||||||
|
// 7. Cleanup temp wave CSV
|
||||||
|
Bash(`rm -f ${sessionFolder}/wave-${wave}.csv ${sessionFolder}/wave-${wave}-results.csv`)
|
||||||
|
|
||||||
|
// 8. Display wave summary
|
||||||
|
const completed = waveResults.filter(r => r.status === 'completed').length
|
||||||
|
const failed = waveResults.filter(r => r.status === 'failed').length
|
||||||
|
// Output: "Wave {wave}: {completed} completed, {failed} failed"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Instruction Template** (embedded — see instructions/agent-instruction.md for standalone):
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
function buildInstructionTemplate(sessionFolder, wave) {
|
||||||
|
const phaseNames = {
|
||||||
|
1: 'Global Survey', 2: 'Theoretical Foundations', 3: 'Algorithm Design',
|
||||||
|
4: 'Module Implementation', 5: 'Local Function-Level', 6: 'Integration & QA'
|
||||||
|
}
|
||||||
|
return `## TASK ASSIGNMENT — ${phaseNames[wave]}
|
||||||
|
|
||||||
|
### MANDATORY FIRST STEPS
|
||||||
|
1. Read shared discoveries: ${sessionFolder}/discoveries.ndjson (if exists, skip if not)
|
||||||
|
2. Read project context: .workflow/project-tech.json (if exists)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Your Task
|
||||||
|
|
||||||
|
**Task ID**: {id}
|
||||||
|
**Title**: {title}
|
||||||
|
**Role**: {track_role}
|
||||||
|
**Analysis Dimension**: {analysis_dimension}
|
||||||
|
**Description**: {description}
|
||||||
|
**Formula References**: {formula_refs}
|
||||||
|
**Precision Requirement**: {precision_req}
|
||||||
|
**Scope**: {scope}
|
||||||
|
|
||||||
|
### Previous Tasks' Findings (Context)
|
||||||
|
{prev_context}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Execution Protocol
|
||||||
|
|
||||||
|
1. **Read discoveries**: Load ${sessionFolder}/discoveries.ndjson for shared exploration findings
|
||||||
|
2. **Use context**: Apply previous tasks' findings from prev_context above
|
||||||
|
3. **Execute analysis**:
|
||||||
|
- Read target files within scope: {scope}
|
||||||
|
- Apply analysis criteria for dimension: {analysis_dimension}
|
||||||
|
- Document mathematical formulas in LaTeX notation ($$...$$)
|
||||||
|
- Classify findings by severity (Critical/High/Medium/Low)
|
||||||
|
- Include file:line references for code-related findings
|
||||||
|
4. **Generate document**: Write analysis report to ${sessionFolder}/docs/ following the standard template:
|
||||||
|
- Metadata (Phase, Track, Date)
|
||||||
|
- Executive Summary
|
||||||
|
- Analysis Scope
|
||||||
|
- Findings with severity, evidence, LaTeX formulas, impact, recommendations
|
||||||
|
- Cross-References to other phases
|
||||||
|
- Perspective Package (structured summary for context propagation)
|
||||||
|
5. **Share discoveries**: Append exploration findings to shared board:
|
||||||
|
\`\`\`bash
|
||||||
|
echo '{"ts":"<ISO8601>","worker":"{id}","type":"<type>","data":{...}}' >> ${sessionFolder}/discoveries.ndjson
|
||||||
|
\`\`\`
|
||||||
|
6. **Report result**: Return JSON via report_agent_job_result
|
||||||
|
|
||||||
|
### Discovery Types to Share
|
||||||
|
- \`governing_equation\`: {eq_name, latex, domain, boundary_conditions} — Governing equations found
|
||||||
|
- \`numerical_method\`: {method_name, type, order, stability_class} — Numerical methods identified
|
||||||
|
- \`stability_issue\`: {location, condition_number, severity, description} — Stability concerns
|
||||||
|
- \`convergence_property\`: {method, rate, order, conditions} — Convergence properties
|
||||||
|
- \`precision_risk\`: {location, operation, risk_type, recommendation} — Floating-point precision risks
|
||||||
|
- \`performance_bottleneck\`: {location, operation_count, memory_pattern, suggestion} — Performance issues
|
||||||
|
- \`architecture_pattern\`: {pattern_name, files, description} — Architecture patterns found
|
||||||
|
- \`test_gap\`: {component, missing_coverage, priority} — Missing test coverage
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output (report_agent_job_result)
|
||||||
|
|
||||||
|
Return JSON:
|
||||||
|
{
|
||||||
|
"id": "{id}",
|
||||||
|
"status": "completed" | "failed",
|
||||||
|
"findings": "Key discoveries and conclusions (max 500 chars)",
|
||||||
|
"severity_distribution": "Critical:N High:N Medium:N Low:N",
|
||||||
|
"latex_formulas": "key formulas separated by semicolons",
|
||||||
|
"doc_path": "relative path to generated analysis document",
|
||||||
|
"error": ""
|
||||||
|
}`
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Success Criteria**:
|
||||||
|
- All 6 waves executed in order
|
||||||
|
- Each wave's results merged into master CSV before next wave starts
|
||||||
|
- Dependent tasks skipped when predecessor failed
|
||||||
|
- discoveries.ndjson accumulated across all waves
|
||||||
|
- Analysis documents generated in docs/ directory
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Phase 3: Results Aggregation
|
||||||
|
|
||||||
|
**Objective**: Generate final results and comprehensive human-readable report synthesizing all 6 phases.
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
// 1. Export final results.csv
|
||||||
|
Bash(`cp ${sessionFolder}/tasks.csv ${sessionFolder}/results.csv`)
|
||||||
|
|
||||||
|
// 2. Generate context.md
|
||||||
|
const tasks = parseCsv(Read(`${sessionFolder}/tasks.csv`))
|
||||||
|
const completed = tasks.filter(t => t.status === 'completed').length
|
||||||
|
const failed = tasks.filter(t => t.status === 'failed').length
|
||||||
|
const skipped = tasks.filter(t => t.status === 'skipped').length
|
||||||
|
|
||||||
|
let contextMd = `# Numerical Analysis Report: ${requirement}\n\n`
|
||||||
|
contextMd += `**Session**: ${sessionId}\n`
|
||||||
|
contextMd += `**Date**: ${getUtc8ISOString().substring(0, 10)}\n`
|
||||||
|
contextMd += `**Total Tasks**: ${tasks.length} | Completed: ${completed} | Failed: ${failed} | Skipped: ${skipped}\n\n`
|
||||||
|
|
||||||
|
// Per-wave summary
|
||||||
|
const phaseNames = ['', 'Global Survey', 'Theoretical Foundations', 'Algorithm Design',
|
||||||
|
'Module Implementation', 'Local Function-Level', 'Integration & QA']
|
||||||
|
for (let w = 1; w <= 6; w++) {
|
||||||
|
const waveTasks = tasks.filter(t => t.wave === w)
|
||||||
|
contextMd += `## Wave ${w}: ${phaseNames[w]}\n\n`
|
||||||
|
for (const t of waveTasks) {
|
||||||
|
contextMd += `### ${t.id}: ${t.title} [${t.status}]\n`
|
||||||
|
contextMd += `**Role**: ${t.track_role} | **Dimension**: ${t.analysis_dimension}\n\n`
|
||||||
|
if (t.findings) contextMd += `**Findings**: ${t.findings}\n\n`
|
||||||
|
if (t.latex_formulas) contextMd += `**Key Formulas**:\n$$${t.latex_formulas.split(';').join('$$\n\n$$')}$$\n\n`
|
||||||
|
if (t.severity_distribution) contextMd += `**Issues**: ${t.severity_distribution}\n\n`
|
||||||
|
if (t.doc_path) contextMd += `**Full Report**: [${t.doc_path}](${t.doc_path})\n\n`
|
||||||
|
contextMd += `---\n\n`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Collected formulas section
|
||||||
|
const allFormulas = tasks.filter(t => t.latex_formulas).flatMap(t =>
|
||||||
|
t.latex_formulas.split(';').map(f => ({ task: t.id, formula: f.trim() }))
|
||||||
|
)
|
||||||
|
if (allFormulas.length > 0) {
|
||||||
|
contextMd += `## Collected Mathematical Formulas\n\n`
|
||||||
|
for (const f of allFormulas) {
|
||||||
|
contextMd += `- **${f.task}**: $$${f.formula}$$\n`
|
||||||
|
}
|
||||||
|
contextMd += `\n`
|
||||||
|
}
|
||||||
|
|
||||||
|
// All discoveries summary
|
||||||
|
contextMd += `## Discovery Board Summary\n\n`
|
||||||
|
contextMd += `See: ${sessionFolder}/discoveries.ndjson\n\n`
|
||||||
|
|
||||||
|
Write(`${sessionFolder}/context.md`, contextMd)
|
||||||
|
|
||||||
|
// 3. Display summary
|
||||||
|
// Output wave-by-wave completion status table
|
||||||
|
```
|
||||||
|
|
||||||
|
**Success Criteria**:
|
||||||
|
- results.csv exported
|
||||||
|
- context.md generated with all findings, formulas, cross-references
|
||||||
|
- Summary displayed to user
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Shared Discovery Board Protocol
|
||||||
|
|
||||||
|
### Standard Discovery Types
|
||||||
|
|
||||||
|
| Type | Dedup Key | Data Schema | Description |
|
||||||
|
|------|-----------|-------------|-------------|
|
||||||
|
| `governing_equation` | `eq_name` | `{eq_name, latex, domain, boundary_conditions}` | Governing equations found in the project |
|
||||||
|
| `numerical_method` | `method_name` | `{method_name, type, order, stability_class}` | Numerical methods identified |
|
||||||
|
| `stability_issue` | `location` | `{location, condition_number, severity, description}` | Numerical stability concerns |
|
||||||
|
| `convergence_property` | `method` | `{method, rate, order, conditions}` | Convergence properties proven or observed |
|
||||||
|
| `precision_risk` | `location+operation` | `{location, operation, risk_type, recommendation}` | Floating-point precision risks |
|
||||||
|
| `performance_bottleneck` | `location` | `{location, operation_count, memory_pattern, suggestion}` | Performance bottlenecks |
|
||||||
|
| `architecture_pattern` | `pattern_name` | `{pattern_name, files, description}` | Software architecture patterns |
|
||||||
|
| `test_gap` | `component` | `{component, missing_coverage, priority}` | Missing test coverage |
|
||||||
|
|
||||||
|
### Protocol Rules
|
||||||
|
|
||||||
|
1. **Read first**: Always read discoveries.ndjson before starting analysis
|
||||||
|
2. **Write immediately**: Append discoveries as soon as found, don't batch
|
||||||
|
3. **Deduplicate**: Check dedup key before appending (same key = skip)
|
||||||
|
4. **Append-only**: Never clear, modify, or recreate discoveries.ndjson
|
||||||
|
5. **Cross-wave accumulation**: Discoveries persist and accumulate across all 6 waves
|
||||||
|
|
||||||
|
### NDJSON Format
|
||||||
|
|
||||||
|
```jsonl
|
||||||
|
{"ts":"2026-03-04T10:00:00Z","worker":"T1.1","type":"governing_equation","data":{"eq_name":"Navier-Stokes","latex":"\\rho(\\frac{\\partial \\mathbf{v}}{\\partial t} + \\mathbf{v} \\cdot \\nabla \\mathbf{v}) = -\\nabla p + \\mu \\nabla^2 \\mathbf{v}","domain":"fluid_dynamics","boundary_conditions":"no-slip walls, inlet velocity"}}
|
||||||
|
{"ts":"2026-03-04T10:05:00Z","worker":"T2.2","type":"convergence_property","data":{"method":"Galerkin FEM","rate":"optimal","order":"h^{k+1} in L2","conditions":"quasi-uniform mesh, sufficient regularity"}}
|
||||||
|
{"ts":"2026-03-04T10:10:00Z","worker":"T3.2","type":"stability_issue","data":{"location":"src/solver/assembler.rs:142","condition_number":"1e12","severity":"High","description":"Ill-conditioned stiffness matrix for high aspect ratio elements"}}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Perspective Reuse Matrix
|
||||||
|
|
||||||
|
Each phase's output serves as context for subsequent phases:
|
||||||
|
|
||||||
|
| Source Phase | P2 Reuse | P3 Reuse | P4 Reuse | P5 Reuse | P6 Reuse |
|
||||||
|
|-------------|---------|---------|---------|---------|---------|
|
||||||
|
| P1 Governing Eqs | Formalize → LaTeX | Constrain method selection | Code-equation mapping | Singularity sources | Correctness baseline |
|
||||||
|
| P1 Architecture | Constrain discretization | Parallel strategy | Module boundaries | Hotspot location | Integration scope |
|
||||||
|
| P1 Validation | - | Benchmark selection | Test criteria | Edge case sources | Final validation |
|
||||||
|
| P2 Formulas | - | Parameter constraints | Loop termination | Precision requirements | Theoretical verification |
|
||||||
|
| P2 Convergence | - | Mesh refinement strategy | Iteration control | Error tolerance | Rate verification |
|
||||||
|
| P2 Complexity | - | Performance baseline | Data structure choice | Optimization targets | Performance comparison |
|
||||||
|
| P3 Pseudocode | - | - | Implementation reference | Line-by-line audit | Regression baseline |
|
||||||
|
| P3 Stability | - | - | Precision selection | Cancellation detection | Numerical verification |
|
||||||
|
| P3 Performance | - | - | Memory layout | Vectorization targets | Benchmark targets |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Error Handling
|
||||||
|
|
||||||
|
| Error | Resolution |
|
||||||
|
|-------|------------|
|
||||||
|
| Circular dependency | Detect in wave computation, abort with error message |
|
||||||
|
| Agent timeout | Mark as failed in results, continue with wave |
|
||||||
|
| Agent failed | Mark as failed, skip dependent tasks in later waves |
|
||||||
|
| All agents in wave failed | Log error, offer retry or abort |
|
||||||
|
| CSV parse error | Validate CSV format before execution, show line number |
|
||||||
|
| discoveries.ndjson corrupt | Ignore malformed lines, continue with valid entries |
|
||||||
|
| Continue mode: no session found | List available sessions, prompt user to select |
|
||||||
|
| LaTeX parse error | Store raw formula, flag for manual review |
|
||||||
|
| Scope files not found | Warn and continue with available files |
|
||||||
|
| Precision conflict between tracks | Flag in discoveries, defer to QA_Auditor in Wave 6 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quality Gates (Per-Wave)
|
||||||
|
|
||||||
|
| Wave | Gate Criteria | Threshold |
|
||||||
|
|------|--------------|-----------|
|
||||||
|
| 1 | Core model identified + architecture mapped + KPI defined | All 3 tracks completed |
|
||||||
|
| 2 | Key formulas in LaTeX + convergence conditions stated + complexity determined | All 3 tracks completed |
|
||||||
|
| 3 | Pseudocode producible + stability assessed + performance predicted | ≥ 2 of 3 tracks completed |
|
||||||
|
| 4 | Code-algorithm mapping complete + data structures reviewed + APIs documented | ≥ 2 of 3 tracks completed |
|
||||||
|
| 5 | Hotspots identified + edge cases cataloged + precision risks flagged | ≥ 2 of 3 tracks completed |
|
||||||
|
| 6 | Test plan complete + benchmarks run + QA report synthesized | All 3 tracks completed |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Core Rules
|
||||||
|
|
||||||
|
1. **Start Immediately**: First action is session initialization, then Phase 1
|
||||||
|
2. **Wave Order is Sacred**: Never execute wave N before wave N-1 completes and results are merged
|
||||||
|
3. **CSV is Source of Truth**: Master tasks.csv holds all state
|
||||||
|
4. **Context Propagation**: prev_context built from master CSV findings, not from memory
|
||||||
|
5. **Discovery Board is Append-Only**: Never clear, modify, or recreate discoveries.ndjson
|
||||||
|
6. **Skip on Failure**: If a dependency failed, skip the dependent task
|
||||||
|
7. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
|
||||||
|
8. **LaTeX Preservation**: Mathematical formulas must be preserved in LaTeX notation throughout all phases
|
||||||
|
9. **Perspective Compounding**: Each wave MUST receive cumulative context from all preceding waves
|
||||||
|
10. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
||||||
@@ -0,0 +1,179 @@
|
|||||||
|
# Agent Instruction Template
|
||||||
|
|
||||||
|
Template for generating agent instruction prompts used in `spawn_agents_on_csv`.
|
||||||
|
|
||||||
|
## Key Concept
|
||||||
|
|
||||||
|
The instruction template is a **prompt with column placeholders** (`{column_name}`). When `spawn_agents_on_csv` executes, each agent receives the template with its row's column values substituted.
|
||||||
|
|
||||||
|
**Critical rule**: The instruction template is the ONLY context the agent has. It must be self-contained — the agent cannot access the master CSV or other agents' data.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Template
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## TASK ASSIGNMENT — Numerical Analysis
|
||||||
|
|
||||||
|
### MANDATORY FIRST STEPS
|
||||||
|
1. Read shared discoveries: {session_folder}/discoveries.ndjson (if exists, skip if not)
|
||||||
|
2. Read project context: .workflow/project-tech.json (if exists)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Your Task
|
||||||
|
|
||||||
|
**Task ID**: {id}
|
||||||
|
**Title**: {title}
|
||||||
|
**Role**: {track_role}
|
||||||
|
**Analysis Dimension**: {analysis_dimension}
|
||||||
|
**Description**: {description}
|
||||||
|
**Formula References**: {formula_refs}
|
||||||
|
**Precision Requirement**: {precision_req}
|
||||||
|
**Scope**: {scope}
|
||||||
|
|
||||||
|
### Previous Tasks' Findings (Context)
|
||||||
|
{prev_context}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Execution Protocol
|
||||||
|
|
||||||
|
1. **Read discoveries**: Load {session_folder}/discoveries.ndjson for shared exploration findings from other tracks
|
||||||
|
2. **Use context**: Apply previous tasks' findings from prev_context above — this contains cumulative analysis from all preceding phases
|
||||||
|
3. **Execute analysis based on your role**:
|
||||||
|
|
||||||
|
#### For Domain Analysis Roles (Wave 1: Problem_Domain_Analyst, Software_Architect, Validation_Strategist)
|
||||||
|
- Survey the project codebase within scope: {scope}
|
||||||
|
- Identify mathematical models, governing equations, boundary conditions
|
||||||
|
- Map software architecture: modules, data flow, dependencies
|
||||||
|
- Define validation strategy: benchmarks, KPIs, acceptance criteria
|
||||||
|
|
||||||
|
#### For Theory Roles (Wave 2: Mathematician, Convergence_Analyst, Complexity_Analyst)
|
||||||
|
- Build on governing equations from Wave 1 context
|
||||||
|
- Derive precise mathematical formulations using LaTeX notation
|
||||||
|
- Prove or analyze convergence properties with error bounds
|
||||||
|
- Determine computational complexity (time and space)
|
||||||
|
- All formulas MUST use LaTeX: `$$formula$$`
|
||||||
|
|
||||||
|
#### For Algorithm Roles (Wave 3: Algorithm_Designer, Stability_Analyst, Performance_Modeler)
|
||||||
|
- Select numerical methods based on theoretical analysis from Wave 2
|
||||||
|
- Write algorithm pseudocode for core computational kernels
|
||||||
|
- Analyze condition numbers and error propagation
|
||||||
|
- Build performance model: FLOPS count, memory bandwidth, parallel efficiency
|
||||||
|
|
||||||
|
#### For Module Roles (Wave 4: Module_Implementer, Data_Structure_Designer, Interface_Analyst)
|
||||||
|
- Map algorithms from Wave 3 to actual code modules
|
||||||
|
- Review data structures: sparse matrix formats, mesh data, memory layout
|
||||||
|
- Document module interfaces, data contracts, error handling patterns
|
||||||
|
|
||||||
|
#### For Local Analysis Roles (Wave 5: Code_Optimizer, Edge_Case_Analyst, Precision_Auditor)
|
||||||
|
- Identify performance hotspots with file:line references
|
||||||
|
- Catalog edge cases: singularities, division by zero, overflow/underflow
|
||||||
|
- Audit floating-point operations for catastrophic cancellation, accumulation errors
|
||||||
|
- Provide specific optimization recommendations (vectorization, cache, parallelism)
|
||||||
|
|
||||||
|
#### For Integration Roles (Wave 6: Integration_Tester, Benchmark_Engineer, QA_Auditor)
|
||||||
|
- Design end-to-end test plans using benchmarks from Wave 1
|
||||||
|
- Run or plan performance benchmarks comparing actual vs theoretical (Wave 3)
|
||||||
|
- Synthesize ALL findings from Waves 1-5 into final quality report
|
||||||
|
- Produce risk matrix and improvement roadmap
|
||||||
|
|
||||||
|
4. **Generate analysis document**: Write to {session_folder}/docs/ using this template:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# [Phase {wave}] {title}
|
||||||
|
|
||||||
|
## Metadata
|
||||||
|
- **Phase**: {wave} | **Track**: {id} | **Role**: {track_role}
|
||||||
|
- **Dimension**: {analysis_dimension}
|
||||||
|
- **Date**: [ISO8601]
|
||||||
|
- **Input Context**: Context from tasks {context_from}
|
||||||
|
|
||||||
|
## Executive Summary
|
||||||
|
[2-3 sentences: core conclusions]
|
||||||
|
|
||||||
|
## Analysis Scope
|
||||||
|
[Boundaries, assumptions, files analyzed within {scope}]
|
||||||
|
|
||||||
|
## Findings
|
||||||
|
|
||||||
|
### Finding 1: [Title]
|
||||||
|
**Severity**: Critical / High / Medium / Low
|
||||||
|
**Evidence**: [Code reference file:line or formula derivation]
|
||||||
|
$$\text{LaTeX formula if applicable}$$
|
||||||
|
**Impact**: [Effect on project correctness, performance, or stability]
|
||||||
|
**Recommendation**: [Specific actionable suggestion]
|
||||||
|
|
||||||
|
### Finding N: ...
|
||||||
|
|
||||||
|
## Mathematical Formulas
|
||||||
|
[All key formulas derived or referenced in this analysis]
|
||||||
|
|
||||||
|
## Cross-References
|
||||||
|
[References to findings from other phases/tracks]
|
||||||
|
|
||||||
|
## Perspective Package
|
||||||
|
[Structured summary for context propagation to later phases]
|
||||||
|
- Key conclusions: ...
|
||||||
|
- Formulas for reuse: ...
|
||||||
|
- Open questions: ...
|
||||||
|
- Risks identified: ...
|
||||||
|
```
|
||||||
|
|
||||||
|
5. **Share discoveries**: Append findings to shared board:
|
||||||
|
```bash
|
||||||
|
echo '{"ts":"<ISO8601>","worker":"{id}","type":"<type>","data":{...}}' >> {session_folder}/discoveries.ndjson
|
||||||
|
```
|
||||||
|
|
||||||
|
6. **Report result**: Return JSON via report_agent_job_result
|
||||||
|
|
||||||
|
### Discovery Types to Share
|
||||||
|
- `governing_equation`: {eq_name, latex, domain, boundary_conditions} — Governing equations found
|
||||||
|
- `numerical_method`: {method_name, type, order, stability_class} — Numerical methods identified
|
||||||
|
- `stability_issue`: {location, condition_number, severity, description} — Stability concerns
|
||||||
|
- `convergence_property`: {method, rate, order, conditions} — Convergence properties
|
||||||
|
- `precision_risk`: {location, operation, risk_type, recommendation} — Float precision risks
|
||||||
|
- `performance_bottleneck`: {location, operation_count, memory_pattern, suggestion} — Performance issues
|
||||||
|
- `architecture_pattern`: {pattern_name, files, description} — Architecture patterns found
|
||||||
|
- `test_gap`: {component, missing_coverage, priority} — Missing test coverage
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output (report_agent_job_result)
|
||||||
|
|
||||||
|
Return JSON:
|
||||||
|
{
|
||||||
|
"id": "{id}",
|
||||||
|
"status": "completed" | "failed",
|
||||||
|
"findings": "Key discoveries and conclusions (max 500 chars)",
|
||||||
|
"severity_distribution": "Critical:N High:N Medium:N Low:N",
|
||||||
|
"latex_formulas": "key formulas in LaTeX separated by semicolons",
|
||||||
|
"doc_path": "relative path to generated analysis document (e.g., docs/P2_Mathematical_Formulation.md)",
|
||||||
|
"error": ""
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Placeholder Distinction
|
||||||
|
|
||||||
|
| Syntax | Resolved By | When |
|
||||||
|
|--------|-----------|------|
|
||||||
|
| `{column_name}` | spawn_agents_on_csv | During agent execution (runtime) |
|
||||||
|
| `{session_folder}` | Wave engine | Before spawning (set in instruction string) |
|
||||||
|
|
||||||
|
The SKILL.md embeds this template with `{session_folder}` replaced by the actual session path. Column placeholders `{column_name}` remain for runtime substitution.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Instruction Size Guidelines
|
||||||
|
|
||||||
|
| Track Type | Target Length | Notes |
|
||||||
|
|-----------|-------------|-------|
|
||||||
|
| Wave 1 (Global) | 500-1000 chars | Broad survey, needs exploration guidance |
|
||||||
|
| Wave 2 (Theory) | 1000-2000 chars | Requires mathematical rigor instructions |
|
||||||
|
| Wave 3 (Algorithm) | 1000-1500 chars | Needs pseudocode format guidance |
|
||||||
|
| Wave 4 (Module) | 800-1200 chars | Focused on code-algorithm mapping |
|
||||||
|
| Wave 5 (Local) | 800-1500 chars | Detailed precision/optimization criteria |
|
||||||
|
| Wave 6 (Integration) | 1500-2500 chars | Must synthesize all prior phases |
|
||||||
@@ -0,0 +1,162 @@
|
|||||||
|
# Numerical Analysis Workflow — CSV Schema
|
||||||
|
|
||||||
|
## Master CSV: tasks.csv
|
||||||
|
|
||||||
|
### Column Definitions
|
||||||
|
|
||||||
|
#### Input Columns (Set by Decomposer)
|
||||||
|
|
||||||
|
| Column | Type | Required | Description | Example |
|
||||||
|
|--------|------|----------|-------------|---------|
|
||||||
|
| `id` | string | Yes | Unique task identifier (T{wave}.{track}) | `"T2.1"` |
|
||||||
|
| `title` | string | Yes | Short task title | `"Mathematical Formulation"` |
|
||||||
|
| `description` | string | Yes | Detailed task description (self-contained) | `"Derive precise mathematical formulations..."` |
|
||||||
|
| `track_role` | string | Yes | Analysis role name | `"Mathematician"` |
|
||||||
|
| `analysis_dimension` | string | Yes | Analysis focus area | `"formula_derivation"` |
|
||||||
|
| `formula_refs` | string | No | References to formulas from earlier tasks (TaskID:formula_name;...) | `"T1.1:governing_eqs;T2.2:convergence_conds"` |
|
||||||
|
| `precision_req` | string | No | Required floating-point precision | `"double"` |
|
||||||
|
| `scope` | string | No | File/directory scope for analysis (glob) | `"src/solver/**"` |
|
||||||
|
| `deps` | string | No | Semicolon-separated dependency task IDs | `"T2.1;T2.2"` |
|
||||||
|
| `context_from` | string | No | Semicolon-separated task IDs for context | `"T1.1;T2.1"` |
|
||||||
|
|
||||||
|
#### Computed Columns (Set by Wave Engine)
|
||||||
|
|
||||||
|
| Column | Type | Description | Example |
|
||||||
|
|--------|------|-------------|---------|
|
||||||
|
| `wave` | integer | Wave number (1-6, fixed per diamond topology) | `3` |
|
||||||
|
| `prev_context` | string | Aggregated findings + formulas from context_from tasks (per-wave CSV only) | `"[T2.1] Weak form derived..."` |
|
||||||
|
|
||||||
|
#### Output Columns (Set by Agent)
|
||||||
|
|
||||||
|
| Column | Type | Description | Example |
|
||||||
|
|--------|------|-------------|---------|
|
||||||
|
| `status` | enum | `pending` → `completed` / `failed` / `skipped` | `"completed"` |
|
||||||
|
| `findings` | string | Key discoveries (max 500 chars) | `"Identified CFL condition..."` |
|
||||||
|
| `severity_distribution` | string | Issue counts by severity | `"Critical:0 High:2 Medium:3 Low:1"` |
|
||||||
|
| `latex_formulas` | string | Key LaTeX formulas (semicolon-separated) | `"\\Delta t \\leq \\frac{h}{c};\\kappa(A) = \\|A\\|\\|A^{-1}\\|"` |
|
||||||
|
| `doc_path` | string | Path to generated analysis document | `"docs/P3_Numerical_Stability_Report.md"` |
|
||||||
|
| `error` | string | Error message if failed | `""` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Example Data
|
||||||
|
|
||||||
|
```csv
|
||||||
|
id,title,description,track_role,analysis_dimension,formula_refs,precision_req,scope,deps,context_from,wave,status,findings,severity_distribution,latex_formulas,doc_path,error
|
||||||
|
"T1.1","Problem Domain Survey","Survey governing equations and mathematical models. Identify PDE types, boundary conditions, conservation laws, and physical domain.","Problem_Domain_Analyst","domain_modeling","","","src/**","","","1","completed","Identified Navier-Stokes equations with k-epsilon turbulence model. Incompressible flow assumption. No-slip boundary conditions.","Critical:0 High:0 Medium:1 Low:2","\\rho(\\frac{\\partial v}{\\partial t} + v \\cdot \\nabla v) = -\\nabla p + \\mu \\nabla^2 v","docs/P1_Domain_Survey.md",""
|
||||||
|
"T2.1","Mathematical Formulation","Derive precise mathematical formulations using LaTeX. Transform governing equations into weak forms suitable for FEM discretization.","Mathematician","formula_derivation","T1.1:governing_eqs","","src/**","T1.1","T1.1","2","completed","Weak form derived for NS equations. Galerkin formulation with inf-sup stable elements (Taylor-Hood P2/P1).","Critical:0 High:0 Medium:0 Low:1","\\int_\\Omega \\mu \\nabla u : \\nabla v \\, d\\Omega - \\int_\\Omega p \\nabla \\cdot v \\, d\\Omega = \\int_\\Omega f \\cdot v \\, d\\Omega","docs/P2_Mathematical_Formulation.md",""
|
||||||
|
"T3.2","Numerical Stability Report","Analyze numerical stability of selected algorithms. Evaluate condition numbers, error propagation characteristics, and precision requirements.","Stability_Analyst","stability_analysis","T2.1:weak_forms;T2.2:convergence_conds","double","src/solver/**","T2.1;T2.2","T2.1;T2.2","3","pending","","","","",""
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Column Lifecycle
|
||||||
|
|
||||||
|
```
|
||||||
|
Decomposer (Phase 1) Wave Engine (Phase 2) Agent (Execution)
|
||||||
|
───────────────────── ──────────────────── ─────────────────
|
||||||
|
id ───────────► id ──────────► id
|
||||||
|
title ───────────► title ──────────► (reads)
|
||||||
|
description ───────────► description ──────────► (reads)
|
||||||
|
track_role ───────────► track_role ──────────► (reads)
|
||||||
|
analysis_dimension ─────► analysis_dimension ────► (reads)
|
||||||
|
formula_refs ──────────► formula_refs ─────────► (reads)
|
||||||
|
precision_req ─────────► precision_req ─────────► (reads)
|
||||||
|
scope ───────────► scope ──────────► (reads)
|
||||||
|
deps ───────────► deps ──────────► (reads)
|
||||||
|
context_from───────────► context_from──────────► (reads)
|
||||||
|
wave ──────────► (reads)
|
||||||
|
prev_context ──────────► (reads)
|
||||||
|
status
|
||||||
|
findings
|
||||||
|
severity_distribution
|
||||||
|
latex_formulas
|
||||||
|
doc_path
|
||||||
|
error
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output Schema (JSON)
|
||||||
|
|
||||||
|
Agent output via `report_agent_job_result`:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"id": { "type": "string", "description": "Task ID (T{wave}.{track})" },
|
||||||
|
"status": { "type": "string", "enum": ["completed", "failed"] },
|
||||||
|
"findings": { "type": "string", "description": "Key discoveries, max 500 chars" },
|
||||||
|
"severity_distribution": { "type": "string", "description": "Critical:N High:N Medium:N Low:N" },
|
||||||
|
"latex_formulas": { "type": "string", "description": "Key formulas in LaTeX, semicolon-separated" },
|
||||||
|
"doc_path": { "type": "string", "description": "Path to generated analysis document" },
|
||||||
|
"error": { "type": "string", "description": "Error message if failed" }
|
||||||
|
},
|
||||||
|
"required": ["id", "status", "findings"]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Discovery Types
|
||||||
|
|
||||||
|
| Type | Dedup Key | Data Schema | Description |
|
||||||
|
|------|-----------|-------------|-------------|
|
||||||
|
| `governing_equation` | `eq_name` | `{eq_name, latex, domain, boundary_conditions}` | Governing equations found |
|
||||||
|
| `numerical_method` | `method_name` | `{method_name, type, order, stability_class}` | Numerical methods identified |
|
||||||
|
| `stability_issue` | `location` | `{location, condition_number, severity, description}` | Stability concerns |
|
||||||
|
| `convergence_property` | `method` | `{method, rate, order, conditions}` | Convergence properties |
|
||||||
|
| `precision_risk` | `location+operation` | `{location, operation, risk_type, recommendation}` | Float precision risks |
|
||||||
|
| `performance_bottleneck` | `location` | `{location, operation_count, memory_pattern, suggestion}` | Performance bottlenecks |
|
||||||
|
| `architecture_pattern` | `pattern_name` | `{pattern_name, files, description}` | Architecture patterns |
|
||||||
|
| `test_gap` | `component` | `{component, missing_coverage, priority}` | Missing test coverage |
|
||||||
|
|
||||||
|
### Discovery NDJSON Format
|
||||||
|
|
||||||
|
```jsonl
|
||||||
|
{"ts":"2026-03-04T10:00:00Z","worker":"T1.1","type":"governing_equation","data":{"eq_name":"Navier-Stokes","latex":"\\rho(\\frac{\\partial v}{\\partial t} + v \\cdot \\nabla v) = -\\nabla p + \\mu \\nabla^2 v","domain":"fluid_dynamics","boundary_conditions":"no-slip walls"}}
|
||||||
|
{"ts":"2026-03-04T10:05:00Z","worker":"T2.2","type":"convergence_property","data":{"method":"Galerkin FEM","rate":"optimal","order":"h^{k+1}","conditions":"quasi-uniform mesh"}}
|
||||||
|
{"ts":"2026-03-04T10:10:00Z","worker":"T3.2","type":"stability_issue","data":{"location":"src/solver/assembler.rs:142","condition_number":"1e12","severity":"High","description":"Ill-conditioned stiffness matrix"}}
|
||||||
|
{"ts":"2026-03-04T10:15:00Z","worker":"T5.3","type":"precision_risk","data":{"location":"src/solver/residual.rs:87","operation":"subtraction of nearly equal values","risk_type":"catastrophic_cancellation","recommendation":"Use compensated summation or reformulate"}}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Validation Rules
|
||||||
|
|
||||||
|
| Rule | Check | Error |
|
||||||
|
|------|-------|-------|
|
||||||
|
| Unique IDs | No duplicate `id` values | "Duplicate task ID: {id}" |
|
||||||
|
| Valid deps | All dep IDs exist in tasks | "Unknown dependency: {dep_id}" |
|
||||||
|
| No self-deps | Task cannot depend on itself | "Self-dependency: {id}" |
|
||||||
|
| No circular deps | Topological sort completes | "Circular dependency detected involving: {ids}" |
|
||||||
|
| context_from valid | All context IDs exist and in earlier waves | "Invalid context_from: {id}" |
|
||||||
|
| Description non-empty | Every task has description | "Empty description for task: {id}" |
|
||||||
|
| Status enum | status in {pending, completed, failed, skipped} | "Invalid status: {status}" |
|
||||||
|
| Wave range | wave in {1..6} | "Invalid wave number: {wave}" |
|
||||||
|
| Track role valid | track_role matches known roles | "Unknown track_role: {role}" |
|
||||||
|
| Formula refs format | TaskID:formula_name pattern | "Malformed formula_refs: {value}" |
|
||||||
|
|
||||||
|
### Analysis Dimension Values
|
||||||
|
|
||||||
|
| Dimension | Used In Wave | Description |
|
||||||
|
|-----------|-------------|-------------|
|
||||||
|
| `domain_modeling` | 1 | Physical/mathematical domain survey |
|
||||||
|
| `architecture_analysis` | 1 | Software architecture analysis |
|
||||||
|
| `validation_design` | 1 | Validation and benchmark strategy |
|
||||||
|
| `formula_derivation` | 2 | Mathematical formulation and derivation |
|
||||||
|
| `convergence_analysis` | 2 | Convergence theory and error bounds |
|
||||||
|
| `complexity_analysis` | 2 | Computational complexity analysis |
|
||||||
|
| `method_selection` | 3 | Numerical method selection and design |
|
||||||
|
| `stability_analysis` | 3 | Numerical stability assessment |
|
||||||
|
| `performance_modeling` | 3 | Performance prediction and modeling |
|
||||||
|
| `implementation_analysis` | 4 | Module-level code analysis |
|
||||||
|
| `data_structure_review` | 4 | Data structure and memory layout review |
|
||||||
|
| `interface_analysis` | 4 | API contract and interface analysis |
|
||||||
|
| `optimization` | 5 | Function-level performance optimization |
|
||||||
|
| `edge_case_analysis` | 5 | Boundary and singularity handling |
|
||||||
|
| `precision_audit` | 5 | Floating-point precision audit |
|
||||||
|
| `integration_testing` | 6 | System integration testing |
|
||||||
|
| `benchmarking` | 6 | Performance benchmarking |
|
||||||
|
| `quality_assurance` | 6 | Final quality audit and synthesis |
|
||||||
@@ -0,0 +1,237 @@
|
|||||||
|
# Analysis Dimensions for Numerical Computation
|
||||||
|
|
||||||
|
Defines the 18 analysis dimensions across 6 phases of the NADW workflow.
|
||||||
|
|
||||||
|
## Purpose
|
||||||
|
|
||||||
|
| Phase | Usage |
|
||||||
|
|-------|-------|
|
||||||
|
| Phase 1 (Decomposition) | Reference when assigning analysis_dimension to tasks |
|
||||||
|
| Phase 2 (Execution) | Agents use to understand their analysis focus |
|
||||||
|
| Phase 3 (Aggregation) | Organize findings by dimension |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Wave 1: Global Survey Dimensions
|
||||||
|
|
||||||
|
### 1.1 Domain Modeling (`domain_modeling`)
|
||||||
|
|
||||||
|
**Analyst Role**: Problem_Domain_Analyst
|
||||||
|
|
||||||
|
**Focus Areas**:
|
||||||
|
- Governing equations (PDEs, ODEs, integral equations)
|
||||||
|
- Physical domain and boundary conditions
|
||||||
|
- Conservation laws and constitutive relations
|
||||||
|
- Problem classification (elliptic, parabolic, hyperbolic)
|
||||||
|
- Dimensional analysis and non-dimensionalization
|
||||||
|
|
||||||
|
**Key Outputs**:
|
||||||
|
- Equation inventory with LaTeX notation
|
||||||
|
- Boundary condition catalog
|
||||||
|
- Problem classification matrix
|
||||||
|
- Physical parameter ranges
|
||||||
|
|
||||||
|
**Formula Types to Identify**:
|
||||||
|
$$\frac{\partial u}{\partial t} + \mathcal{L}u = f \quad \text{(general PDE form)}$$
|
||||||
|
$$u|_{\partial\Omega} = g \quad \text{(Dirichlet BC)}$$
|
||||||
|
$$\frac{\partial u}{\partial n}|_{\partial\Omega} = h \quad \text{(Neumann BC)}$$
|
||||||
|
|
||||||
|
### 1.2 Architecture Analysis (`architecture_analysis`)
|
||||||
|
|
||||||
|
**Analyst Role**: Software_Architect
|
||||||
|
|
||||||
|
**Focus Areas**:
|
||||||
|
- Module decomposition and dependency graph
|
||||||
|
- Data flow between computational stages
|
||||||
|
- I/O patterns (mesh input, solution output, checkpointing)
|
||||||
|
- Parallelism strategy (MPI, OpenMP, GPU)
|
||||||
|
- Build system and dependency management
|
||||||
|
|
||||||
|
**Key Outputs**:
|
||||||
|
- High-level component diagram
|
||||||
|
- Data flow diagram
|
||||||
|
- Technology stack inventory
|
||||||
|
- Parallelism strategy assessment
|
||||||
|
|
||||||
|
### 1.3 Validation Design (`validation_design`)
|
||||||
|
|
||||||
|
**Analyst Role**: Validation_Strategist
|
||||||
|
|
||||||
|
**Focus Areas**:
|
||||||
|
- Benchmark cases with known analytical solutions
|
||||||
|
- Manufactured solution methodology
|
||||||
|
- Grid convergence study design
|
||||||
|
- Key Performance Indicators (KPIs)
|
||||||
|
- Acceptance criteria definition
|
||||||
|
|
||||||
|
**Key Outputs**:
|
||||||
|
- Benchmark case catalog
|
||||||
|
- Validation methodology matrix
|
||||||
|
- KPI definitions with targets
|
||||||
|
- Acceptance test specifications
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Wave 2: Theoretical Foundation Dimensions
|
||||||
|
|
||||||
|
### 2.1 Formula Derivation (`formula_derivation`)
|
||||||
|
|
||||||
|
**Analyst Role**: Mathematician
|
||||||
|
|
||||||
|
**Focus Areas**:
|
||||||
|
- Strong-to-weak form transformation
|
||||||
|
- Discretization schemes (FEM, FDM, FVM, spectral)
|
||||||
|
- Variational formulations
|
||||||
|
- Linearization techniques (Newton, Picard)
|
||||||
|
- Stabilization methods (SUPG, GLS, VMS)
|
||||||
|
|
||||||
|
**Key Formula Templates**:
|
||||||
|
$$\text{Weak form: } a(u,v) = l(v) \quad \forall v \in V_h$$
|
||||||
|
$$a(u,v) = \int_\Omega \nabla u \cdot \nabla v \, d\Omega$$
|
||||||
|
$$l(v) = \int_\Omega f v \, d\Omega + \int_{\Gamma_N} g v \, dS$$
|
||||||
|
|
||||||
|
### 2.2 Convergence Analysis (`convergence_analysis`)
|
||||||
|
|
||||||
|
**Analyst Role**: Convergence_Analyst
|
||||||
|
|
||||||
|
**Focus Areas**:
|
||||||
|
- A priori error estimates
|
||||||
|
- A posteriori error estimators
|
||||||
|
- Convergence order verification
|
||||||
|
- Lax equivalence theorem applicability
|
||||||
|
- CFL conditions for time-dependent problems
|
||||||
|
|
||||||
|
**Key Formula Templates**:
|
||||||
|
$$\|u - u_h\|_{L^2} \leq C h^{k+1} |u|_{H^{k+1}} \quad \text{(optimal L2 rate)}$$
|
||||||
|
$$\|u - u_h\|_{H^1} \leq C h^k |u|_{H^{k+1}} \quad \text{(optimal H1 rate)}$$
|
||||||
|
$$\Delta t \leq \frac{C h}{\|v\|_\infty} \quad \text{(CFL condition)}$$
|
||||||
|
|
||||||
|
### 2.3 Complexity Analysis (`complexity_analysis`)
|
||||||
|
|
||||||
|
**Analyst Role**: Complexity_Analyst
|
||||||
|
|
||||||
|
**Focus Areas**:
|
||||||
|
- Assembly operation counts
|
||||||
|
- Solver complexity (direct vs iterative)
|
||||||
|
- Preconditioner cost analysis
|
||||||
|
- Memory scaling with problem size
|
||||||
|
- Communication overhead in parallel settings
|
||||||
|
|
||||||
|
**Key Formula Templates**:
|
||||||
|
$$T_{assembly} = O(N_{elem} \cdot p^{2d}) \quad \text{(FEM assembly)}$$
|
||||||
|
$$T_{solve} = O(N^{3/2}) \quad \text{(2D direct)}, \quad O(N \log N) \quad \text{(multigrid)}$$
|
||||||
|
$$M_{storage} = O(nnz) \quad \text{(sparse storage)}$$
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Wave 3: Algorithm Design Dimensions
|
||||||
|
|
||||||
|
### 3.1 Method Selection (`method_selection`)
|
||||||
|
|
||||||
|
**Analyst Role**: Algorithm_Designer
|
||||||
|
|
||||||
|
**Focus Areas**:
|
||||||
|
- Spatial discretization method selection
|
||||||
|
- Time integration scheme selection
|
||||||
|
- Linear/nonlinear solver selection
|
||||||
|
- Preconditioner selection
|
||||||
|
- Mesh generation strategy
|
||||||
|
|
||||||
|
**Decision Criteria**:
|
||||||
|
|
||||||
|
| Criterion | Weight | Metrics |
|
||||||
|
|-----------|--------|---------|
|
||||||
|
| Accuracy order | High | Convergence rate, error bounds |
|
||||||
|
| Stability | High | Unconditional vs conditional, CFL |
|
||||||
|
| Efficiency | Medium | FLOPS per DOF, memory per DOF |
|
||||||
|
| Parallelizability | Medium | Communication-to-computation ratio |
|
||||||
|
| Implementation complexity | Low | Lines of code, library availability |
|
||||||
|
|
||||||
|
### 3.2 Stability Analysis (`stability_analysis`)
|
||||||
|
|
||||||
|
**Analyst Role**: Stability_Analyst
|
||||||
|
|
||||||
|
**Focus Areas**:
|
||||||
|
- Von Neumann stability analysis
|
||||||
|
- Matrix condition numbers
|
||||||
|
- Amplification factors
|
||||||
|
- Inf-sup (LBB) stability for mixed methods
|
||||||
|
- Mesh-dependent stability bounds
|
||||||
|
|
||||||
|
**Key Formula Templates**:
|
||||||
|
$$\kappa(A) = \|A\| \cdot \|A^{-1}\| \quad \text{(condition number)}$$
|
||||||
|
$$|g(\xi)| \leq 1 \quad \forall \xi \quad \text{(von Neumann stability)}$$
|
||||||
|
$$\inf_{q_h \in Q_h} \sup_{v_h \in V_h} \frac{b(v_h, q_h)}{\|v_h\| \|q_h\|} \geq \beta > 0 \quad \text{(inf-sup)}$$
|
||||||
|
|
||||||
|
### 3.3 Performance Modeling (`performance_modeling`)
|
||||||
|
|
||||||
|
**Analyst Role**: Performance_Modeler
|
||||||
|
|
||||||
|
**Focus Areas**:
|
||||||
|
- Arithmetic intensity (FLOPS/byte)
|
||||||
|
- Roofline model analysis
|
||||||
|
- Strong/weak scaling prediction
|
||||||
|
- Memory bandwidth bottleneck identification
|
||||||
|
- Cache utilization estimates
|
||||||
|
|
||||||
|
**Key Formula Templates**:
|
||||||
|
$$AI = \frac{\text{FLOPS}}{\text{Bytes transferred}} \quad \text{(arithmetic intensity)}$$
|
||||||
|
$$P_{max} = \min(P_{peak}, AI \times BW_{mem}) \quad \text{(roofline bound)}$$
|
||||||
|
$$E_{parallel}(p) = \frac{T_1}{p \cdot T_p} \quad \text{(parallel efficiency)}$$
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Wave 4: Module Implementation Dimensions
|
||||||
|
|
||||||
|
### 4.1 Implementation Analysis (`implementation_analysis`)
|
||||||
|
|
||||||
|
**Focus**: Algorithm-to-code mapping, implementation correctness, coding patterns
|
||||||
|
|
||||||
|
### 4.2 Data Structure Review (`data_structure_review`)
|
||||||
|
|
||||||
|
**Focus**: Sparse matrix formats (CSR/CSC/COO), mesh data structures, memory layout optimization
|
||||||
|
|
||||||
|
### 4.3 Interface Analysis (`interface_analysis`)
|
||||||
|
|
||||||
|
**Focus**: Module APIs, data contracts between components, error handling patterns
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Wave 5: Local Function-Level Dimensions
|
||||||
|
|
||||||
|
### 5.1 Optimization (`optimization`)
|
||||||
|
|
||||||
|
**Focus**: Hotspot identification, vectorization opportunities, cache optimization, loop restructuring
|
||||||
|
|
||||||
|
### 5.2 Edge Case Analysis (`edge_case_analysis`)
|
||||||
|
|
||||||
|
**Focus**: Division by zero, matrix singularity, degenerate mesh elements, boundary layer singularities
|
||||||
|
|
||||||
|
### 5.3 Precision Audit (`precision_audit`)
|
||||||
|
|
||||||
|
**Focus**: Catastrophic cancellation, accumulation errors, mixed-precision opportunities, compensated algorithms
|
||||||
|
|
||||||
|
**Critical Patterns to Detect**:
|
||||||
|
|
||||||
|
| Pattern | Risk | Mitigation |
|
||||||
|
|---------|------|-----------|
|
||||||
|
| `a - b` where `a ≈ b` | Catastrophic cancellation | Reformulate or use higher precision |
|
||||||
|
| `sum += small_value` in loop | Accumulation error | Kahan summation |
|
||||||
|
| `1.0/x` where `x → 0` | Overflow/loss of significance | Guard with threshold |
|
||||||
|
| Mixed float32/float64 | Silent precision loss | Explicit type annotations |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Wave 6: Integration & QA Dimensions
|
||||||
|
|
||||||
|
### 6.1 Integration Testing (`integration_testing`)
|
||||||
|
|
||||||
|
**Focus**: End-to-end test design, regression suite, manufactured solutions verification
|
||||||
|
|
||||||
|
### 6.2 Benchmarking (`benchmarking`)
|
||||||
|
|
||||||
|
**Focus**: Actual vs predicted performance, scalability tests, profiling results
|
||||||
|
|
||||||
|
### 6.3 Quality Assurance (`quality_assurance`)
|
||||||
|
|
||||||
|
**Focus**: All-phase synthesis, risk matrix, improvement roadmap, final recommendations
|
||||||
@@ -0,0 +1,214 @@
|
|||||||
|
# Phase Topology — Diamond Deep Tree
|
||||||
|
|
||||||
|
Wave coordination patterns for the Numerical Analysis Diamond Workflow (NADW).
|
||||||
|
|
||||||
|
## Purpose
|
||||||
|
|
||||||
|
| Phase | Usage |
|
||||||
|
|-------|-------|
|
||||||
|
| Phase 1 (Decomposition) | Reference when assigning waves and dependencies |
|
||||||
|
| Phase 2 (Execution) | Context flow between waves |
|
||||||
|
| Phase 3 (Aggregation) | Structure the final report by topology |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Topology Overview
|
||||||
|
|
||||||
|
The NADW uses a **Staged Diamond** topology — six sequential waves, each with 3 parallel tracks. Context flows cumulatively from earlier waves to later ones.
|
||||||
|
|
||||||
|
```
|
||||||
|
Wave 1: [T1.1] [T1.2] [T1.3] Global Survey (3 parallel)
|
||||||
|
↓ Context P1
|
||||||
|
Wave 2: [T2.1] [T2.2] [T2.3] Theory (3 parallel)
|
||||||
|
↓ Context P1+P2
|
||||||
|
Wave 3: [T3.1] [T3.2] [T3.3] Algorithm (3 parallel)
|
||||||
|
↓ Context P1+P2+P3
|
||||||
|
Wave 4: [T4.1] [T4.2] [T4.3] Module (3 parallel)
|
||||||
|
↓ Context P1-P4
|
||||||
|
Wave 5: [T5.1] [T5.2] [T5.3] Local (3 parallel)
|
||||||
|
↓ Context P1-P5
|
||||||
|
Wave 6: [T6.1] [T6.2] [T6.3] Integration (3 parallel)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Wave Definitions
|
||||||
|
|
||||||
|
### Wave 1: Global Survey
|
||||||
|
|
||||||
|
| Property | Value |
|
||||||
|
|----------|-------|
|
||||||
|
| Phase Name | Global Survey |
|
||||||
|
| Track Count | 3 |
|
||||||
|
| Dependencies | None (entry wave) |
|
||||||
|
| Context Input | Project codebase only |
|
||||||
|
| Context Output | Governing equations, architecture map, validation KPIs |
|
||||||
|
| Max Parallelism | 3 |
|
||||||
|
|
||||||
|
**Tracks**:
|
||||||
|
| ID | Role | Dimension | Scope |
|
||||||
|
|----|------|-----------|-------|
|
||||||
|
| T1.1 | Problem_Domain_Analyst | domain_modeling | Full project |
|
||||||
|
| T1.2 | Software_Architect | architecture_analysis | Full project |
|
||||||
|
| T1.3 | Validation_Strategist | validation_design | Full project |
|
||||||
|
|
||||||
|
### Wave 2: Theoretical Foundations
|
||||||
|
|
||||||
|
| Property | Value |
|
||||||
|
|----------|-------|
|
||||||
|
| Phase Name | Theoretical Foundations |
|
||||||
|
| Track Count | 3 |
|
||||||
|
| Dependencies | Wave 1 |
|
||||||
|
| Context Input | Context Package P1 |
|
||||||
|
| Context Output | LaTeX formulas, convergence theorems, complexity bounds |
|
||||||
|
| Max Parallelism | 3 |
|
||||||
|
|
||||||
|
**Tracks**:
|
||||||
|
| ID | Role | Dimension | Deps | context_from |
|
||||||
|
|----|------|-----------|------|-------------|
|
||||||
|
| T2.1 | Mathematician | formula_derivation | T1.1 | T1.1 |
|
||||||
|
| T2.2 | Convergence_Analyst | convergence_analysis | T1.1 | T1.1 |
|
||||||
|
| T2.3 | Complexity_Analyst | complexity_analysis | T1.1;T1.2 | T1.1;T1.2 |
|
||||||
|
|
||||||
|
### Wave 3: Algorithm Design & Stability
|
||||||
|
|
||||||
|
| Property | Value |
|
||||||
|
|----------|-------|
|
||||||
|
| Phase Name | Algorithm Design |
|
||||||
|
| Track Count | 3 |
|
||||||
|
| Dependencies | Wave 2 |
|
||||||
|
| Context Input | Context Package P1+P2 |
|
||||||
|
| Context Output | Pseudocode, stability conditions, performance model |
|
||||||
|
| Max Parallelism | 3 |
|
||||||
|
|
||||||
|
**Tracks**:
|
||||||
|
| ID | Role | Dimension | Deps | context_from |
|
||||||
|
|----|------|-----------|------|-------------|
|
||||||
|
| T3.1 | Algorithm_Designer | method_selection | T2.1 | T2.1;T2.2;T2.3 |
|
||||||
|
| T3.2 | Stability_Analyst | stability_analysis | T2.1;T2.2 | T2.1;T2.2 |
|
||||||
|
| T3.3 | Performance_Modeler | performance_modeling | T2.3 | T1.2;T2.3 |
|
||||||
|
|
||||||
|
### Wave 4: Module Implementation
|
||||||
|
|
||||||
|
| Property | Value |
|
||||||
|
|----------|-------|
|
||||||
|
| Phase Name | Module Implementation |
|
||||||
|
| Track Count | 3 |
|
||||||
|
| Dependencies | Wave 3 |
|
||||||
|
| Context Input | Context Package P1-P3 |
|
||||||
|
| Context Output | Code-algorithm mapping, data structure decisions, API contracts |
|
||||||
|
| Max Parallelism | 3 |
|
||||||
|
|
||||||
|
**Tracks**:
|
||||||
|
| ID | Role | Dimension | Deps | context_from |
|
||||||
|
|----|------|-----------|------|-------------|
|
||||||
|
| T4.1 | Module_Implementer | implementation_analysis | T3.1 | T1.2;T3.1 |
|
||||||
|
| T4.2 | Data_Structure_Designer | data_structure_review | T3.1;T3.3 | T2.3;T3.1;T3.3 |
|
||||||
|
| T4.3 | Interface_Analyst | interface_analysis | T3.1 | T1.2;T3.1 |
|
||||||
|
|
||||||
|
### Wave 5: Local Function-Level
|
||||||
|
|
||||||
|
| Property | Value |
|
||||||
|
|----------|-------|
|
||||||
|
| Phase Name | Local Function-Level |
|
||||||
|
| Track Count | 3 |
|
||||||
|
| Dependencies | Wave 4 |
|
||||||
|
| Context Input | Context Package P1-P4 |
|
||||||
|
| Context Output | Optimization recommendations, edge case catalog, precision risk matrix |
|
||||||
|
| Max Parallelism | 3 |
|
||||||
|
|
||||||
|
**Tracks**:
|
||||||
|
| ID | Role | Dimension | Deps | context_from |
|
||||||
|
|----|------|-----------|------|-------------|
|
||||||
|
| T5.1 | Code_Optimizer | optimization | T4.1 | T3.3;T4.1 |
|
||||||
|
| T5.2 | Edge_Case_Analyst | edge_case_analysis | T4.1 | T1.1;T3.2;T4.1 |
|
||||||
|
| T5.3 | Precision_Auditor | precision_audit | T4.1;T4.2 | T3.2;T4.1;T4.2 |
|
||||||
|
|
||||||
|
### Wave 6: Integration & QA
|
||||||
|
|
||||||
|
| Property | Value |
|
||||||
|
|----------|-------|
|
||||||
|
| Phase Name | Integration & QA |
|
||||||
|
| Track Count | 3 |
|
||||||
|
| Dependencies | Wave 5 |
|
||||||
|
| Context Input | Context Package P1-P5 (ALL cumulative) |
|
||||||
|
| Context Output | Final test plan, benchmark report, QA assessment |
|
||||||
|
| Max Parallelism | 3 |
|
||||||
|
|
||||||
|
**Tracks**:
|
||||||
|
| ID | Role | Dimension | Deps | context_from |
|
||||||
|
|----|------|-----------|------|-------------|
|
||||||
|
| T6.1 | Integration_Tester | integration_testing | T5.1;T5.2 | T1.3;T5.1;T5.2 |
|
||||||
|
| T6.2 | Benchmark_Engineer | benchmarking | T5.1 | T1.3;T3.3;T5.1 |
|
||||||
|
| T6.3 | QA_Auditor | quality_assurance | T5.1;T5.2;T5.3 | T1.1;T2.1;T3.1;T4.1;T5.1;T5.2;T5.3 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Context Flow Map
|
||||||
|
|
||||||
|
### Directed Context (prev_context column)
|
||||||
|
|
||||||
|
```
|
||||||
|
T1.1 ──► T2.1, T2.2, T2.3
|
||||||
|
T1.2 ──► T2.3, T3.3, T4.1, T4.3
|
||||||
|
T1.3 ──► T6.1, T6.2
|
||||||
|
T2.1 ──► T3.1, T3.2
|
||||||
|
T2.2 ──► T3.1, T3.2
|
||||||
|
T2.3 ──► T3.1, T3.3, T4.2
|
||||||
|
T3.1 ──► T4.1, T4.2, T4.3
|
||||||
|
T3.2 ──► T5.2, T5.3
|
||||||
|
T3.3 ──► T4.2, T5.1, T6.2
|
||||||
|
T4.1 ──► T5.1, T5.2, T5.3
|
||||||
|
T4.2 ──► T5.3
|
||||||
|
T5.1 ──► T6.1, T6.2
|
||||||
|
T5.2 ──► T6.1
|
||||||
|
T5.3 ──► T6.3
|
||||||
|
```
|
||||||
|
|
||||||
|
### Broadcast Context (discoveries.ndjson)
|
||||||
|
|
||||||
|
All agents read/append to the same discoveries.ndjson. Key discovery types flow across waves:
|
||||||
|
|
||||||
|
```
|
||||||
|
Wave 1: governing_equation, architecture_pattern ──► all subsequent waves
|
||||||
|
Wave 2: convergence_property ──► Wave 3-6
|
||||||
|
Wave 3: stability_issue, numerical_method ──► Wave 4-6
|
||||||
|
Wave 4: (implementation findings) ──► Wave 5-6
|
||||||
|
Wave 5: precision_risk, performance_bottleneck ──► Wave 6
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Perspective Reuse Matrix
|
||||||
|
|
||||||
|
How each wave's output is reused by later waves:
|
||||||
|
|
||||||
|
| Source | P2 Reuse | P3 Reuse | P4 Reuse | P5 Reuse | P6 Reuse |
|
||||||
|
|--------|---------|---------|---------|---------|---------|
|
||||||
|
| **P1 Equations** | Formalize → LaTeX | Constrain methods | Code-eq mapping | Singularity sources | Correctness baseline |
|
||||||
|
| **P1 Architecture** | Constrain discretization | Parallel strategy | Module boundaries | Hotspot location | Integration scope |
|
||||||
|
| **P1 Validation** | - | Benchmark selection | Test criteria | Edge case sources | Final validation |
|
||||||
|
| **P2 Formulas** | - | Parameter constraints | Loop termination | Precision requirements | Theory verification |
|
||||||
|
| **P2 Convergence** | - | Mesh refinement | Iteration control | Error tolerance | Rate verification |
|
||||||
|
| **P2 Complexity** | - | Performance baseline | Data structure choice | Optimization targets | Perf comparison |
|
||||||
|
| **P3 Pseudocode** | - | - | Impl reference | Line-by-line audit | Regression baseline |
|
||||||
|
| **P3 Stability** | - | - | Precision selection | Cancellation detection | Numerical verification |
|
||||||
|
| **P3 Performance** | - | - | Memory layout | Vectorization targets | Benchmark targets |
|
||||||
|
| **P4 Modules** | - | - | - | Function-level focus | Module test plan |
|
||||||
|
| **P5 Optimization** | - | - | - | - | Performance tests |
|
||||||
|
| **P5 Edge Cases** | - | - | - | - | Regression tests |
|
||||||
|
| **P5 Precision** | - | - | - | - | Numerical tests |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Diamond Properties
|
||||||
|
|
||||||
|
| Property | Value |
|
||||||
|
|----------|-------|
|
||||||
|
| Total Waves | 6 |
|
||||||
|
| Total Tasks | 18 (3 per wave) |
|
||||||
|
| Max Parallelism per Wave | 3 |
|
||||||
|
| Widest Context Fan-in | T6.3 (receives from 7 tasks) |
|
||||||
|
| Deepest Dependency Chain | T1.1 → T2.1 → T3.1 → T4.1 → T5.1 → T6.1 (depth 6) |
|
||||||
|
| Context Accumulation | Cumulative (each wave adds to previous context) |
|
||||||
|
| Topology Type | Staged Parallel with Diamond convergence at Wave 6 |
|
||||||
@@ -0,0 +1,173 @@
|
|||||||
|
# Quality Standards for Numerical Analysis Workflow
|
||||||
|
|
||||||
|
Quality assessment criteria for NADW analysis reports.
|
||||||
|
|
||||||
|
## When to Use
|
||||||
|
|
||||||
|
| Phase | Usage | Section |
|
||||||
|
|-------|-------|---------|
|
||||||
|
| Phase 2 (Execution) | Guide agent analysis quality | All dimensions |
|
||||||
|
| Phase 3 (Aggregation) | Score generated reports | Quality Gates |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quality Dimensions
|
||||||
|
|
||||||
|
### 1. Mathematical Rigor (30%)
|
||||||
|
|
||||||
|
| Score | Criteria |
|
||||||
|
|-------|----------|
|
||||||
|
| 100% | All formulas correct, properly derived, LaTeX well-formatted, error bounds proven |
|
||||||
|
| 80% | Formulas correct, some derivation steps skipped, bounds stated without full proof |
|
||||||
|
| 60% | Key formulas present, some notation inconsistencies, bounds estimated |
|
||||||
|
| 40% | Formulas incomplete or contain errors |
|
||||||
|
| 0% | No mathematical content |
|
||||||
|
|
||||||
|
**Checklist**:
|
||||||
|
- [ ] Governing equations identified and written in LaTeX
|
||||||
|
- [ ] Weak forms correctly derived from strong forms
|
||||||
|
- [ ] Convergence order stated with conditions
|
||||||
|
- [ ] Error bounds provided (a priori or a posteriori)
|
||||||
|
- [ ] CFL/stability conditions explicitly stated
|
||||||
|
- [ ] Condition numbers estimated for key matrices
|
||||||
|
- [ ] Complexity bounds (time and space) determined
|
||||||
|
- [ ] LaTeX notation consistent throughout all documents
|
||||||
|
|
||||||
|
### 2. Code-Theory Mapping (25%)
|
||||||
|
|
||||||
|
| Score | Criteria |
|
||||||
|
|-------|----------|
|
||||||
|
| 100% | Every algorithm mapped to code with file:line references, data structures justified |
|
||||||
|
| 80% | Major algorithms mapped, most references accurate |
|
||||||
|
| 60% | Key mappings present, some code references missing |
|
||||||
|
| 40% | Superficial mapping, few code references |
|
||||||
|
| 0% | No code-theory connection |
|
||||||
|
|
||||||
|
**Checklist**:
|
||||||
|
- [ ] Each numerical method traced to implementing function/module
|
||||||
|
- [ ] Data structures justified against algorithm requirements
|
||||||
|
- [ ] Sparse matrix format matched to access patterns
|
||||||
|
- [ ] Time integration scheme identified in code
|
||||||
|
- [ ] Boundary condition implementation verified
|
||||||
|
- [ ] Solver configuration traced to convergence requirements
|
||||||
|
- [ ] Preconditioner choice justified
|
||||||
|
|
||||||
|
### 3. Numerical Quality Assessment (25%)
|
||||||
|
|
||||||
|
| Score | Criteria |
|
||||||
|
|-------|----------|
|
||||||
|
| 100% | Stability fully analyzed, precision risks cataloged, all edge cases covered |
|
||||||
|
| 80% | Stability assessed, major precision risks found, common edge cases covered |
|
||||||
|
| 60% | Basic stability check, some precision risks, incomplete edge cases |
|
||||||
|
| 40% | Superficial stability mention, few precision issues found |
|
||||||
|
| 0% | No numerical quality analysis |
|
||||||
|
|
||||||
|
**Checklist**:
|
||||||
|
- [ ] Condition numbers estimated for key operations
|
||||||
|
- [ ] Catastrophic cancellation risks identified with file:line
|
||||||
|
- [ ] Accumulation error potential assessed
|
||||||
|
- [ ] Float precision choices justified (float32 vs float64)
|
||||||
|
- [ ] Edge cases cataloged (singularities, degenerate inputs)
|
||||||
|
- [ ] Overflow/underflow risks identified
|
||||||
|
- [ ] Mixed-precision operations flagged
|
||||||
|
|
||||||
|
### 4. Cross-Phase Coherence (20%)
|
||||||
|
|
||||||
|
| Score | Criteria |
|
||||||
|
|-------|----------|
|
||||||
|
| 100% | All 6 phases connected, findings build on each other, no contradictions |
|
||||||
|
| 80% | Most phases connected, minor gaps in context propagation |
|
||||||
|
| 60% | Key connections present, some phases isolated |
|
||||||
|
| 40% | Limited cross-referencing between phases |
|
||||||
|
| 0% | Phases completely isolated |
|
||||||
|
|
||||||
|
**Checklist**:
|
||||||
|
- [ ] Wave 2 formulas reference Wave 1 governing equations
|
||||||
|
- [ ] Wave 3 algorithms justified by Wave 2 theory
|
||||||
|
- [ ] Wave 4 implementation verified against Wave 3 pseudocode
|
||||||
|
- [ ] Wave 5 optimization targets from Wave 3 performance model
|
||||||
|
- [ ] Wave 5 precision requirements from Wave 2/3 analysis
|
||||||
|
- [ ] Wave 6 test plan covers findings from all prior waves
|
||||||
|
- [ ] Wave 6 benchmarks compare against Wave 3 predictions
|
||||||
|
- [ ] No contradictory findings between phases
|
||||||
|
- [ ] Discoveries board used for cross-track sharing
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quality Gates (Per-Wave)
|
||||||
|
|
||||||
|
| Wave | Phase | Gate Criteria | Required Tracks |
|
||||||
|
|------|-------|--------------|-----------------|
|
||||||
|
| 1 | Global Survey | Core model identified + architecture mapped + ≥1 KPI | 3/3 completed |
|
||||||
|
| 2 | Theory | Key formulas LaTeX'd + convergence stated + complexity determined | 3/3 completed |
|
||||||
|
| 3 | Algorithm | Pseudocode produced + stability assessed + performance predicted | ≥2/3 completed |
|
||||||
|
| 4 | Module | Code-algorithm mapping + data structures reviewed + APIs documented | ≥2/3 completed |
|
||||||
|
| 5 | Local | Hotspots identified + edge cases cataloged + precision risks flagged | ≥2/3 completed |
|
||||||
|
| 6 | Integration | Test plan complete + benchmarks planned + QA report synthesized | 3/3 completed |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Overall Quality Gates
|
||||||
|
|
||||||
|
| Gate | Threshold | Action |
|
||||||
|
|------|-----------|--------|
|
||||||
|
| PASS | >= 80% across all dimensions | Report ready for delivery |
|
||||||
|
| REVIEW | 70-79% in any dimension | Flag dimension for improvement, user decides |
|
||||||
|
| FAIL | < 70% in any dimension | Block delivery, identify gaps, suggest re-analysis |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Issue Classification
|
||||||
|
|
||||||
|
### Errors (Must Fix)
|
||||||
|
|
||||||
|
- Missing governing equation identification (Wave 1)
|
||||||
|
- LaTeX formulas with mathematical errors (Wave 2)
|
||||||
|
- Algorithm pseudocode that doesn't match convergence requirements (Wave 3)
|
||||||
|
- Code references to non-existent files/functions (Wave 4)
|
||||||
|
- Unidentified catastrophic cancellation in critical path (Wave 5)
|
||||||
|
- Test plan that doesn't cover identified stability issues (Wave 6)
|
||||||
|
- Contradictory findings between phases
|
||||||
|
- Missing context propagation (later phase ignores earlier findings)
|
||||||
|
|
||||||
|
### Warnings (Should Fix)
|
||||||
|
|
||||||
|
- Formulas without derivation steps
|
||||||
|
- Convergence bounds stated without proof or reference
|
||||||
|
- Missing edge case for known singularity
|
||||||
|
- Performance model without memory bandwidth consideration
|
||||||
|
- Data structure choice not justified
|
||||||
|
- Test plan without manufactured solution verification
|
||||||
|
- Benchmark without theoretical baseline comparison
|
||||||
|
|
||||||
|
### Notes (Nice to Have)
|
||||||
|
|
||||||
|
- Additional bibliography references
|
||||||
|
- Alternative algorithm comparisons
|
||||||
|
- Extended precision sensitivity analysis
|
||||||
|
- Scaling prediction beyond current problem size
|
||||||
|
- Code style or naming convention suggestions
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Severity Levels for Findings
|
||||||
|
|
||||||
|
| Severity | Definition | Example |
|
||||||
|
|----------|-----------|---------|
|
||||||
|
| **Critical** | Incorrect results or numerical failure | Wrong boundary condition → divergent solution |
|
||||||
|
| **High** | Significant accuracy or performance degradation | Condition number 10^15 → double precision insufficient |
|
||||||
|
| **Medium** | Suboptimal but functional | O(N^2) where O(N log N) is possible |
|
||||||
|
| **Low** | Minor improvement opportunity | Unnecessary array copy in non-critical path |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Document Quality Metrics
|
||||||
|
|
||||||
|
| Metric | Target | Measurement |
|
||||||
|
|--------|--------|-------------|
|
||||||
|
| Formula coverage | ≥ 90% of core equations in LaTeX | Count identified vs documented |
|
||||||
|
| Code reference density | ≥ 1 file:line per finding | Count references per finding |
|
||||||
|
| Cross-phase references | ≥ 3 per document (Waves 3-6) | Count cross-references |
|
||||||
|
| Severity distribution | ≥ 1 per severity level | Count per level |
|
||||||
|
| Discovery board contributions | ≥ 2 per track | Count NDJSON entries per worker |
|
||||||
|
| Perspective package | Present in every document | Boolean per document |
|
||||||
@@ -77,8 +77,8 @@ export function inferTeamStatus(team: string): TeamMeta['status'] {
|
|||||||
export function getEffectiveTeamMeta(team: string): TeamMeta {
|
export function getEffectiveTeamMeta(team: string): TeamMeta {
|
||||||
const meta = readTeamMeta(team);
|
const meta = readTeamMeta(team);
|
||||||
if (meta) {
|
if (meta) {
|
||||||
// Enrich from legacy files if role_state/pipeline_mode missing
|
// Enrich from legacy files if key fields are missing
|
||||||
if (!meta.role_state || !meta.pipeline_mode) {
|
if (!meta.role_state || !meta.pipeline_mode || !meta.roles || !meta.pipeline_stages) {
|
||||||
const legacyData = readLegacyFiles(team);
|
const legacyData = readLegacyFiles(team);
|
||||||
if (!meta.pipeline_mode && legacyData.pipeline_mode) {
|
if (!meta.pipeline_mode && legacyData.pipeline_mode) {
|
||||||
meta.pipeline_mode = legacyData.pipeline_mode;
|
meta.pipeline_mode = legacyData.pipeline_mode;
|
||||||
@@ -92,6 +92,9 @@ export function getEffectiveTeamMeta(team: string): TeamMeta {
|
|||||||
if (!meta.team_name && legacyData.team_name) {
|
if (!meta.team_name && legacyData.team_name) {
|
||||||
meta.team_name = legacyData.team_name;
|
meta.team_name = legacyData.team_name;
|
||||||
}
|
}
|
||||||
|
if (!meta.roles && legacyData.roles) {
|
||||||
|
meta.roles = legacyData.roles;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
return meta;
|
return meta;
|
||||||
}
|
}
|
||||||
@@ -155,7 +158,14 @@ function readLegacyFiles(team: string): Partial<TeamMeta> {
|
|||||||
if (!result.pipeline_stages && session.pipeline_stages) result.pipeline_stages = session.pipeline_stages;
|
if (!result.pipeline_stages && session.pipeline_stages) result.pipeline_stages = session.pipeline_stages;
|
||||||
if (session.team_name) result.team_name = session.team_name;
|
if (session.team_name) result.team_name = session.team_name;
|
||||||
if (session.task_description) result.task_description = session.task_description;
|
if (session.task_description) result.task_description = session.task_description;
|
||||||
if (session.roles) result.roles = session.roles;
|
// Handle both string[] and { name: string }[] formats
|
||||||
|
if (session.roles && Array.isArray(session.roles)) {
|
||||||
|
if (typeof session.roles[0] === 'string') {
|
||||||
|
result.roles = session.roles;
|
||||||
|
} else if (typeof session.roles[0] === 'object' && session.roles[0] !== null && 'name' in session.roles[0]) {
|
||||||
|
result.roles = session.roles.map((r: { name: string }) => r.name);
|
||||||
|
}
|
||||||
|
}
|
||||||
} catch { /* ignore parse errors */ }
|
} catch { /* ignore parse errors */ }
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -227,6 +227,6 @@ ccw cli -p "Review code quality" --tool gemini --mode analysis --rule analysis-r
|
|||||||
|
|
||||||
## Related Documentation
|
## Related Documentation
|
||||||
|
|
||||||
- [Skills Reference](../skills/)
|
- [Skills Reference](../../skills/)
|
||||||
- [CLI Invocation System](../../features/cli.md)
|
- [CLI Invocation System](../../features/cli.md)
|
||||||
- [Workflow Guide](../../guide/ch04-workflow-basics.md)
|
- [Workflow Guide](../../guide/ch04-workflow-basics.md)
|
||||||
|
|||||||
@@ -291,4 +291,4 @@ graph TD
|
|||||||
|
|
||||||
- [Workflow Commands](./workflow.md)
|
- [Workflow Commands](./workflow.md)
|
||||||
- [Core Orchestration](./core-orchestration.md)
|
- [Core Orchestration](./core-orchestration.md)
|
||||||
- [Team System](../../features/)
|
- [Team System](../../features/spec)
|
||||||
|
|||||||
@@ -304,4 +304,4 @@ graph TD
|
|||||||
|
|
||||||
- [Core Orchestration](./core-orchestration.md)
|
- [Core Orchestration](./core-orchestration.md)
|
||||||
- [Workflow Commands](./workflow.md)
|
- [Workflow Commands](./workflow.md)
|
||||||
- [Brainstorming](../../features/)
|
- [Brainstorming](../../features/spec)
|
||||||
|
|||||||
@@ -53,4 +53,4 @@ CONSTRAINTS: [focus constraints]
|
|||||||
|
|
||||||
- [Claude Commands](../claude/)
|
- [Claude Commands](../claude/)
|
||||||
- [CLI Invocation System](../../features/cli.md)
|
- [CLI Invocation System](../../features/cli.md)
|
||||||
- [Code Review](../../features/)
|
- [Code Review](../../features/spec)
|
||||||
|
|||||||
@@ -194,4 +194,4 @@ git log --oneline -10
|
|||||||
|
|
||||||
- [Prep Prompts](./prep.md)
|
- [Prep Prompts](./prep.md)
|
||||||
- [CLI Tool Commands](../claude/cli.md)
|
- [CLI Tool Commands](../claude/cli.md)
|
||||||
- [Code Review](../../features/)
|
- [Code Review](../../features/spec)
|
||||||
|
|||||||
@@ -33,53 +33,53 @@
|
|||||||
|-----------|-------------|-------|
|
|-----------|-------------|-------|
|
||||||
| [Button](/components/ui/button) | Clickable action buttons with variants and sizes | `variant`, `size`, `asChild` |
|
| [Button](/components/ui/button) | Clickable action buttons with variants and sizes | `variant`, `size`, `asChild` |
|
||||||
| [Input](/components/ui/input) | Text input field | `error` |
|
| [Input](/components/ui/input) | Text input field | `error` |
|
||||||
| [Textarea](/components/ui/textarea) | Multi-line text input | `error` |
|
| Textarea | Multi-line text input | `error` |
|
||||||
| [Select](/components/ui/select) | Dropdown selection (Radix) | Select components |
|
| [Select](/components/ui/select) | Dropdown selection (Radix) | Select components |
|
||||||
| [Checkbox](/components/ui/checkbox) | Boolean checkbox (Radix) | `checked`, `onCheckedChange` |
|
| [Checkbox](/components/ui/checkbox) | Boolean checkbox (Radix) | `checked`, `onCheckedChange` |
|
||||||
| [Switch](/components/ui/switch) | Toggle switch | `checked`, `onCheckedChange` |
|
| Switch | Toggle switch | `checked`, `onCheckedChange` |
|
||||||
|
|
||||||
### Layout Components
|
### Layout Components
|
||||||
|
|
||||||
| Component | Description | Props |
|
| Component | Description | Props |
|
||||||
|-----------|-------------|-------|
|
|-----------|-------------|-------|
|
||||||
| [Card](/components/ui/card) | Content container with header/footer | Nested components |
|
| [Card](/components/ui/card) | Content container with header/footer | Nested components |
|
||||||
| [Separator](/components/ui/separator) | Visual divider | `orientation` |
|
| Separator | Visual divider | `orientation` |
|
||||||
| [ScrollArea](/components/ui/scroll-area) | Custom scrollbar container | - |
|
| ScrollArea | Custom scrollbar container | - |
|
||||||
|
|
||||||
### Feedback Components
|
### Feedback Components
|
||||||
|
|
||||||
| Component | Description | Props |
|
| Component | Description | Props |
|
||||||
|-----------|-------------|-------|
|
|-----------|-------------|-------|
|
||||||
| [Badge](/components/ui/badge) | Status indicator label | `variant` |
|
| [Badge](/components/ui/badge) | Status indicator label | `variant` |
|
||||||
| [Progress](/components/ui/progress) | Progress bar | `value` |
|
| Progress | Progress bar | `value` |
|
||||||
| [Alert](/components/ui/alert) | Notification message | `variant` |
|
| Alert | Notification message | `variant` |
|
||||||
| [Toast](/components/ui/toast) | Temporary notification (Radix) | Toast components |
|
| Toast | Temporary notification (Radix) | Toast components |
|
||||||
|
|
||||||
### Navigation Components
|
### Navigation Components
|
||||||
|
|
||||||
| Component | Description | Props |
|
| Component | Description | Props |
|
||||||
|-----------|-------------|-------|
|
|-----------|-------------|-------|
|
||||||
| [Tabs](/components/ui/tabs) | Tab navigation (Radix) | Tabs components |
|
| Tabs | Tab navigation (Radix) | Tabs components |
|
||||||
| [TabsNavigation](/components/ui/tabs-navigation) | Custom tab bar | `tabs`, `value`, `onValueChange` |
|
| TabsNavigation | Custom tab bar | `tabs`, `value`, `onValueChange` |
|
||||||
| [Breadcrumb](/components/ui/breadcrumb) | Navigation breadcrumb | Breadcrumb components |
|
| Breadcrumb | Navigation breadcrumb | Breadcrumb components |
|
||||||
|
|
||||||
### Overlay Components
|
### Overlay Components
|
||||||
|
|
||||||
| Component | Description | Props |
|
| Component | Description | Props |
|
||||||
|-----------|-------------|-------|
|
|-----------|-------------|-------|
|
||||||
| [Dialog](/components/ui/dialog) | Modal dialog (Radix) | `open`, `onOpenChange` |
|
| Dialog | Modal dialog (Radix) | `open`, `onOpenChange` |
|
||||||
| [Drawer](/components/ui/drawer) | Side panel (Radix) | `open`, `onOpenChange` |
|
| Drawer | Side panel (Radix) | `open`, `onOpenChange` |
|
||||||
| [Dropdown Menu](/components/ui/dropdown) | Context menu (Radix) | Dropdown components |
|
| Dropdown Menu | Context menu (Radix) | Dropdown components |
|
||||||
| [Popover](/components/ui/popover) | Floating content (Radix) | `open`, `onOpenChange` |
|
| Popover | Floating content (Radix) | `open`, `onOpenChange` |
|
||||||
| [Tooltip](/components/ui/tooltip) | Hover tooltip (Radix) | `content` |
|
| Tooltip | Hover tooltip (Radix) | `content` |
|
||||||
| [AlertDialog](/components/ui/alert-dialog) | Confirmation dialog (Radix) | Dialog components |
|
| AlertDialog | Confirmation dialog (Radix) | Dialog components |
|
||||||
|
|
||||||
### Disclosure Components
|
### Disclosure Components
|
||||||
|
|
||||||
| Component | Description | Props |
|
| Component | Description | Props |
|
||||||
|-----------|-------------|-------|
|
|-----------|-------------|-------|
|
||||||
| [Collapsible](/components/ui/collapsible) | Expand/collapse content (Radix) | `open`, `onOpenChange` |
|
| Collapsible | Expand/collapse content (Radix) | `open`, `onOpenChange` |
|
||||||
| [Accordion](/components/ui/accordion) | Collapsible sections (Radix) | Accordion components |
|
| Accordion | Collapsible sections (Radix) | Accordion components |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -116,4 +116,4 @@ Badge with brand gradient background for featured or highlighted items.
|
|||||||
|
|
||||||
- [Card](/components/ui/card)
|
- [Card](/components/ui/card)
|
||||||
- [Button](/components/ui/button)
|
- [Button](/components/ui/button)
|
||||||
- [Avatar](/components/ui/avatar)
|
- Avatar
|
||||||
|
|||||||
@@ -77,4 +77,4 @@ Gradient Primary buttons use the primary theme gradient with an enhanced glow ef
|
|||||||
|
|
||||||
- [Input](/components/ui/input)
|
- [Input](/components/ui/input)
|
||||||
- [Select](/components/ui/select)
|
- [Select](/components/ui/select)
|
||||||
- [Dialog](/components/ui/dialog)
|
- Dialog
|
||||||
|
|||||||
@@ -104,4 +104,4 @@ All Card components accept standard HTML div attributes:
|
|||||||
|
|
||||||
- [Button](/components/ui/button)
|
- [Button](/components/ui/button)
|
||||||
- [Badge](/components/ui/badge)
|
- [Badge](/components/ui/badge)
|
||||||
- [Separator](/components/ui/separator)
|
- Separator
|
||||||
|
|||||||
@@ -117,4 +117,4 @@ const state = ref('indeterminate')
|
|||||||
|
|
||||||
- [Input](/components/ui/input)
|
- [Input](/components/ui/input)
|
||||||
- [Select](/components/ui/select)
|
- [Select](/components/ui/select)
|
||||||
- [Radio Group](/components/ui/radio-group)
|
- Radio Group
|
||||||
|
|||||||
@@ -160,4 +160,4 @@ const { sessions, findings, /* ... */ } = useIssueDiscovery({
|
|||||||
- [Issue Hub](/features/issue-hub) - Unified issues, queue, and discovery management
|
- [Issue Hub](/features/issue-hub) - Unified issues, queue, and discovery management
|
||||||
- [Queue](/features/queue) - Issue execution queue management
|
- [Queue](/features/queue) - Issue execution queue management
|
||||||
- [Issues Panel](/features/issue-hub) - Issue list and GitHub sync
|
- [Issues Panel](/features/issue-hub) - Issue list and GitHub sync
|
||||||
- [Terminal Dashboard](/features/terminal-dashboard) - Real-time session monitoring
|
- [Terminal Dashboard](/features/terminal) - Real-time session monitoring
|
||||||
|
|||||||
@@ -183,5 +183,5 @@ interface SessionsFilter {
|
|||||||
|
|
||||||
- [Dashboard](/features/dashboard) - Overview of all sessions with statistics
|
- [Dashboard](/features/dashboard) - Overview of all sessions with statistics
|
||||||
- [Lite Tasks](/features/tasks-history) - Lite-plan and multi-cli-plan task management
|
- [Lite Tasks](/features/tasks-history) - Lite-plan and multi-cli-plan task management
|
||||||
- [Terminal Dashboard](/features/terminal-dashboard) - Terminal-first session monitoring
|
- [Terminal Dashboard](/features/terminal) - Terminal-first session monitoring
|
||||||
- [Orchestrator](/features/orchestrator) - Workflow template editor
|
- [Orchestrator](/features/orchestrator) - Workflow template editor
|
||||||
|
|||||||
@@ -291,4 +291,4 @@ edit_file(
|
|||||||
|
|
||||||
- [MCP Setup Guide](./mcp-setup.md) - Configure external MCP servers
|
- [MCP Setup Guide](./mcp-setup.md) - Configure external MCP servers
|
||||||
- [Installation](./installation.md) - CCW installation guide
|
- [Installation](./installation.md) - CCW installation guide
|
||||||
- [Team Workflows](../skills/team-workflows.md) - team-lifecycle documentation
|
- [Team Workflows](/workflows/teams) - team-lifecycle documentation
|
||||||
|
|||||||
13
docs/skills/_shared/SKILL-DESIGN-SPEC.md
Normal file
13
docs/skills/_shared/SKILL-DESIGN-SPEC.md
Normal file
@@ -0,0 +1,13 @@
|
|||||||
|
# CCW Skills Design Specification
|
||||||
|
|
||||||
|
> **Note**: This document is a placeholder. The full specification is being developed.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
This document defines the design standards and conventions for CCW skills.
|
||||||
|
|
||||||
|
## Related Documents
|
||||||
|
|
||||||
|
- [Document Standards](/skills/specs/document-standards)
|
||||||
|
- [Quality Gates](/skills/specs/quality-gates)
|
||||||
|
- [Reference Docs Spec](/skills/specs/reference-docs-spec)
|
||||||
@@ -258,7 +258,7 @@ memory/
|
|||||||
|
|
||||||
- [Claude Commands](../commands/claude/)
|
- [Claude Commands](../commands/claude/)
|
||||||
- [Codex Skills](./codex-index.md)
|
- [Codex Skills](./codex-index.md)
|
||||||
- [Features](../features/)
|
- [Features](../features/spec)
|
||||||
|
|
||||||
## Statistics
|
## Statistics
|
||||||
|
|
||||||
|
|||||||
@@ -230,7 +230,7 @@ Artifacts N×Role Synthesis 1×Role
|
|||||||
**Core Specifications** (required):
|
**Core Specifications** (required):
|
||||||
| Document | Purpose | Priority |
|
| Document | Purpose | Priority |
|
||||||
|----------|---------|----------|
|
|----------|---------|----------|
|
||||||
| [../_shared/SKILL-DESIGN-SPEC.md](../_shared/SKILL-DESIGN-SPEC.md) | General design spec — Defines structure, naming, quality standards for all Skills | **P0 - Critical** |
|
| [_shared/SKILL-DESIGN-SPEC.md](./_shared/SKILL-DESIGN-SPEC.md) | General design spec — Defines structure, naming, quality standards for all Skills | **P0 - Critical** |
|
||||||
| [specs/reference-docs-spec.md](specs/reference-docs-spec.md) | Reference doc generation spec — Ensures generated Skills have appropriate stage-based reference docs | **P0 - Critical** |
|
| [specs/reference-docs-spec.md](specs/reference-docs-spec.md) | Reference doc generation spec — Ensures generated Skills have appropriate stage-based reference docs | **P0 - Critical** |
|
||||||
|
|
||||||
**Template Files** (read before generation):
|
**Template Files** (read before generation):
|
||||||
|
|||||||
@@ -440,7 +440,7 @@ Explore → Document → Log → Analyze → Correct Understanding → Fix → V
|
|||||||
## Related Documentation
|
## Related Documentation
|
||||||
|
|
||||||
- [Claude Skills](./claude-index.md)
|
- [Claude Skills](./claude-index.md)
|
||||||
- [Feature Documentation](../features/)
|
- [Feature Documentation](../features/spec)
|
||||||
|
|
||||||
## Best Practices
|
## Best Practices
|
||||||
|
|
||||||
|
|||||||
@@ -225,6 +225,6 @@ ccw cli -p "审查代码质量" --tool gemini --mode analysis --rule analysis-re
|
|||||||
|
|
||||||
## 相关文档
|
## 相关文档
|
||||||
|
|
||||||
- [Skills 参考](../skills/)
|
- [Skills 参考](../../skills/)
|
||||||
- [CLI 调用系统](../../features/cli.md)
|
- [CLI 调用系统](../../features/cli.md)
|
||||||
- [工作流指南](../../guide/ch04-workflow-basics.md)
|
- [工作流指南](../../guide/ch04-workflow-basics.md)
|
||||||
|
|||||||
@@ -291,4 +291,4 @@ graph TD
|
|||||||
|
|
||||||
- [工作流命令](./workflow.md)
|
- [工作流命令](./workflow.md)
|
||||||
- [核心编排](./core-orchestration.md)
|
- [核心编排](./core-orchestration.md)
|
||||||
- [团队系统](../../features/)
|
- [团队系统](../../features/spec)
|
||||||
|
|||||||
@@ -304,4 +304,4 @@ graph TD
|
|||||||
|
|
||||||
- [核心编排](./core-orchestration.md)
|
- [核心编排](./core-orchestration.md)
|
||||||
- [工作流命令](./workflow.md)
|
- [工作流命令](./workflow.md)
|
||||||
- [头脑风暴](../../features/)
|
- [头脑风暴](../../features/spec)
|
||||||
|
|||||||
@@ -53,4 +53,4 @@ CONSTRAINTS: [关注约束]
|
|||||||
|
|
||||||
- [Claude Commands](../claude/)
|
- [Claude Commands](../claude/)
|
||||||
- [CLI 调用系统](../../features/cli.md)
|
- [CLI 调用系统](../../features/cli.md)
|
||||||
- [代码审查](../../features/)
|
- [代码审查](../../features/spec)
|
||||||
|
|||||||
@@ -194,4 +194,4 @@ git log --oneline -10
|
|||||||
|
|
||||||
- [Prep 提示](./prep.md)
|
- [Prep 提示](./prep.md)
|
||||||
- [CLI 工具命令](../claude/cli.md)
|
- [CLI 工具命令](../claude/cli.md)
|
||||||
- [代码审查](../../features/)
|
- [代码审查](../../features/spec)
|
||||||
|
|||||||
@@ -34,53 +34,53 @@
|
|||||||
|------|------|------|
|
|------|------|------|
|
||||||
| [Button](/components/ui/button) | 可点击的操作按钮，带变体和尺寸 | `variant`, `size`, `asChild` |
|
| [Button](/components/ui/button) | 可点击的操作按钮，带变体和尺寸 | `variant`, `size`, `asChild` |
|
||||||
| [Input](/components/ui/input) | 文本输入字段 | `error` |
|
| [Input](/components/ui/input) | 文本输入字段 | `error` |
|
||||||
| [Textarea](/components/ui/textarea) | 多行文本输入 | `error` |
|
| Textarea | 多行文本输入 | `error` |
|
||||||
| [Select](/components/ui/select) | 下拉选择（Radix） | Select 组件 |
|
| [Select](/components/ui/select) | 下拉选择（Radix） | Select 组件 |
|
||||||
| [Checkbox](/components/ui/checkbox) | 布尔复选框（Radix） | `checked`, `onCheckedChange` |
|
| [Checkbox](/components/ui/checkbox) | 布尔复选框（Radix） | `checked`, `onCheckedChange` |
|
||||||
| [Switch](/components/ui/switch) | 切换开关 | `checked`, `onCheckedChange` |
|
| Switch | 切换开关 | `checked`, `onCheckedChange` |
|
||||||
|
|
||||||
### 布局组件
|
### 布局组件
|
||||||
|
|
||||||
| 组件 | 描述 | Props |
|
| 组件 | 描述 | Props |
|
||||||
|------|------|------|
|
|------|------|------|
|
||||||
| [Card](/components/ui/card) | 带标题/脚注的内容容器 | 嵌套组件 |
|
| [Card](/components/ui/card) | 带标题/脚注的内容容器 | 嵌套组件 |
|
||||||
| [Separator](/components/ui/separator) | 视觉分隔符 | `orientation` |
|
| Separator | 视觉分隔符 | `orientation` |
|
||||||
| [ScrollArea](/components/ui/scroll-area) | 自定义滚动条容器 | - |
|
| ScrollArea | 自定义滚动条容器 | - |
|
||||||
|
|
||||||
### 反馈组件
|
### 反馈组件
|
||||||
|
|
||||||
| 组件 | 描述 | Props |
|
| 组件 | 描述 | Props |
|
||||||
|------|------|------|
|
|------|------|------|
|
||||||
| [Badge](/components/ui/badge) | 状态指示器标签 | `variant` |
|
| [Badge](/components/ui/badge) | 状态指示器标签 | `variant` |
|
||||||
| [Progress](/components/ui/progress) | 进度条 | `value` |
|
| Progress | 进度条 | `value` |
|
||||||
| [Alert](/components/ui/alert) | 通知消息 | `variant` |
|
| Alert | 通知消息 | `variant` |
|
||||||
| [Toast](/components/ui/toast) | 临时通知（Radix） | Toast 组件 |
|
| Toast | 临时通知（Radix） | Toast 组件 |
|
||||||
|
|
||||||
### 导航组件
|
### 导航组件
|
||||||
|
|
||||||
| 组件 | 描述 | Props |
|
| 组件 | 描述 | Props |
|
||||||
|------|------|------|
|
|------|------|------|
|
||||||
| [Tabs](/components/ui/tabs) | 标签页导航（Radix） | Tabs 组件 |
|
| Tabs | 标签页导航（Radix） | Tabs 组件 |
|
||||||
| [TabsNavigation](/components/ui/tabs-navigation) | 自定义标签栏 | `tabs`, `value`, `onValueChange` |
|
| TabsNavigation | 自定义标签栏 | `tabs`, `value`, `onValueChange` |
|
||||||
| [Breadcrumb](/components/ui/breadcrumb) | 导航面包屑 | Breadcrumb 组件 |
|
| Breadcrumb | 导航面包屑 | Breadcrumb 组件 |
|
||||||
|
|
||||||
### 叠加层组件
|
### 叠加层组件
|
||||||
|
|
||||||
| 组件 | 描述 | Props |
|
| 组件 | 描述 | Props |
|
||||||
|------|------|------|
|
|------|------|------|
|
||||||
| [Dialog](/components/ui/dialog) | 模态对话框（Radix） | `open`, `onOpenChange` |
|
| Dialog | 模态对话框（Radix） | `open`, `onOpenChange` |
|
||||||
| [Drawer](/components/ui/drawer) | 侧边面板（Radix） | `open`, `onOpenChange` |
|
| Drawer | 侧边面板（Radix） | `open`, `onOpenChange` |
|
||||||
| [Dropdown Menu](/components/ui/dropdown) | 上下文菜单（Radix） | Dropdown 组件 |
|
| Dropdown Menu | 上下文菜单（Radix） | Dropdown 组件 |
|
||||||
| [Popover](/components/ui/popover) | 浮动内容（Radix） | `open`, `onOpenChange` |
|
| Popover | 浮动内容（Radix） | `open`, `onOpenChange` |
|
||||||
| [Tooltip](/components/ui/tooltip) | 悬停工具提示（Radix） | `content` |
|
| Tooltip | 悬停工具提示（Radix） | `content` |
|
||||||
| [AlertDialog](/components/ui/alert-dialog) | 确认对话框（Radix） | Dialog 组件 |
|
| AlertDialog | 确认对话框（Radix） | Dialog 组件 |
|
||||||
|
|
||||||
### 展开组件
|
### 展开组件
|
||||||
|
|
||||||
| 组件 | 描述 | Props |
|
| 组件 | 描述 | Props |
|
||||||
|------|------|------|
|
|------|------|------|
|
||||||
| [Collapsible](/components/ui/collapsible) | 展开/折叠内容（Radix） | `open`, `onOpenChange` |
|
| Collapsible | 展开/折叠内容（Radix） | `open`, `onOpenChange` |
|
||||||
| [Accordion](/components/ui/accordion) | 可折叠部分（Radix） | Accordion 组件 |
|
| Accordion | 可折叠部分（Radix） | Accordion 组件 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -116,4 +116,4 @@ Badge 徽章组件用于以紧凑形式显示状态、类别或标签。它通
|
|||||||
|
|
||||||
- [Card 卡片](/zh/components/ui/card)
|
- [Card 卡片](/zh/components/ui/card)
|
||||||
- [Button 按钮](/zh/components/ui/button)
|
- [Button 按钮](/zh/components/ui/button)
|
||||||
- [Avatar 头像](/zh/components/ui/avatar)
|
- Avatar 头像
|
||||||
|
|||||||
@@ -77,4 +77,4 @@ sidebar: auto
|
|||||||
|
|
||||||
- [Input 输入框](/zh/components/ui/input)
|
- [Input 输入框](/zh/components/ui/input)
|
||||||
- [Select 选择器](/zh/components/ui/select)
|
- [Select 选择器](/zh/components/ui/select)
|
||||||
- [Dialog 对话框](/zh/components/ui/dialog)
|
- Dialog 对话框
|
||||||
|
|||||||
@@ -104,4 +104,4 @@ sidebar: auto
|
|||||||
|
|
||||||
- [Button 按钮](/zh/components/ui/button)
|
- [Button 按钮](/zh/components/ui/button)
|
||||||
- [Badge 徽章](/zh/components/ui/badge)
|
- [Badge 徽章](/zh/components/ui/badge)
|
||||||
- [Separator 分隔线](/zh/components/ui/separator)
|
- Separator 分隔线
|
||||||
|
|||||||
@@ -117,4 +117,4 @@ const state = ref('indeterminate')
|
|||||||
|
|
||||||
- [Input 输入框](/zh/components/ui/input)
|
- [Input 输入框](/zh/components/ui/input)
|
||||||
- [Select 选择器](/zh/components/ui/select)
|
- [Select 选择器](/zh/components/ui/select)
|
||||||
- [Radio Group 单选框组](/zh/components/ui/radio-group)
|
- Radio Group 单选框组
|
||||||
|
|||||||
@@ -43,7 +43,7 @@ ccw cli -p "添加用户认证" --mode write
|
|||||||
|
|
||||||
- [安装指南](./installation.md) - 详细安装说明
|
- [安装指南](./installation.md) - 详细安装说明
|
||||||
- [第一个工作流](./first-workflow.md) - 30 分钟快速入门教程
|
- [第一个工作流](./first-workflow.md) - 30 分钟快速入门教程
|
||||||
- [配置指南](./configuration.md) - 自定义 CCW 设置
|
- [配置指南](/guide/cli-tools) - 自定义 CCW 设置
|
||||||
|
|
||||||
::: tip 需要帮助？
|
::: tip 需要帮助？
|
||||||
查看我们的 [GitHub Discussions](https://github.com/your-repo/ccw/discussions) 或加入 [Discord 社区](https://discord.gg/ccw)。
|
查看我们的 [GitHub Discussions](https://github.com/your-repo/ccw/discussions) 或加入 [Discord 社区](https://discord.gg/ccw)。
|
||||||
|
|||||||
@@ -253,7 +253,7 @@ memory/
|
|||||||
|
|
||||||
- [Claude Commands](../commands/claude/)
|
- [Claude Commands](../commands/claude/)
|
||||||
- [Codex Skills](./codex-index.md)
|
- [Codex Skills](./codex-index.md)
|
||||||
- [功能文档](../features/)
|
- [功能文档](../features/spec)
|
||||||
|
|
||||||
## 统计数据
|
## 统计数据
|
||||||
|
|
||||||
|
|||||||
@@ -73,16 +73,16 @@ Phase 6: Readiness Check -> readiness-report.md + spec-summary.md
|
|||||||
**规范文档**（必读）:
|
**规范文档**（必读）:
|
||||||
| 文档 | 用途 | 优先级 |
|
| 文档 | 用途 | 优先级 |
|
||||||
|------|------|--------|
|
|------|------|--------|
|
||||||
| [specs/document-standards.md](specs/document-standards.md) | 文档格式、frontmatter、命名约定 | **P0 - 执行前必读** |
|
| [specs/document-standards.md](/skills/specs/document-standards) | 文档格式、frontmatter、命名约定 | **P0 - 执行前必读** |
|
||||||
| [specs/quality-gates.md](specs/quality-gates.md) | 每阶段质量关卡标准和评分 | **P0 - 执行前必读** |
|
| [specs/quality-gates.md](/skills/specs/quality-gates) | 每阶段质量关卡标准和评分 | **P0 - 执行前必读** |
|
||||||
|
|
||||||
**模板文件**（生成前必读）:
|
**模板文件**（生成前必读）:
|
||||||
| 文档 | 用途 |
|
| 文档 | 用途 |
|
||||||
|------|------|
|
|------|------|
|
||||||
| [templates/product-brief.md](templates/product-brief.md) | 产品简报文档模板 |
|
| [templates/product-brief.md](/skills/templates/product-brief) | 产品简报文档模板 |
|
||||||
| [templates/requirements-prd.md](templates/requirements-prd.md) | PRD 文档模板 |
|
| [templates/requirements-prd.md](/skills/templates/requirements-prd) | PRD 文档模板 |
|
||||||
| [templates/architecture-doc.md](templates/architecture-doc.md) | 架构文档模板 |
|
| [templates/architecture-doc.md](/skills/templates/architecture-doc) | 架构文档模板 |
|
||||||
| [templates/epics-template.md](templates/epics-template.md) | Epic/Story 文档模板 |
|
| [templates/epics-template.md](/skills/templates/epics-template) | Epic/Story 文档模板 |
|
||||||
|
|
||||||
**输出结构**:
|
**输出结构**:
|
||||||
```plaintext
|
```plaintext
|
||||||
@@ -230,16 +230,16 @@ Artifacts N×Role Synthesis 1×Role
|
|||||||
**核心规范**（必读）:
|
**核心规范**（必读）:
|
||||||
| 文档 | 用途 | 优先级 |
|
| 文档 | 用途 | 优先级 |
|
||||||
|------|------|--------|
|
|------|------|--------|
|
||||||
| [../_shared/SKILL-DESIGN-SPEC.md](../_shared/SKILL-DESIGN-SPEC.md) | 通用设计规范 — 定义所有 Skills 的结构、命名、质量标准 | **P0 - 关键** |
|
| [_shared/SKILL-DESIGN-SPEC.md](/skills/_shared/SKILL-DESIGN-SPEC) | 通用设计规范 — 定义所有 Skills 的结构、命名、质量标准 | **P0 - 关键** |
|
||||||
| [specs/reference-docs-spec.md](specs/reference-docs-spec.md) | 参考文档生成规范 — 确保生成的 Skills 有适当的基于阶段的参考文档 | **P0 - 关键** |
|
| [specs/reference-docs-spec.md](/skills/specs/reference-docs-spec) | 参考文档生成规范 — 确保生成的 Skills 有适当的基于阶段的参考文档 | **P0 - 关键** |
|
||||||
|
|
||||||
**模板文件**（生成前必读）:
|
**模板文件**（生成前必读）:
|
||||||
| 文档 | 用途 |
|
| 文档 | 用途 |
|
||||||
|------|------|
|
|------|------|
|
||||||
| [templates/skill-md.md](templates/skill-md.md) | SKILL.md 入口文件模板 |
|
| [templates/skill-md.md](/skills/templates/skill-md) | SKILL.md 入口文件模板 |
|
||||||
| [templates/sequential-phase.md](templates/sequential-phase.md) | 顺序阶段模板 |
|
| [templates/sequential-phase.md](/skills/templates/sequential-phase) | 顺序阶段模板 |
|
||||||
| [templates/autonomous-orchestrator.md](templates/autonomous-orchestrator.md) | 自治编排器模板 |
|
| [templates/autonomous-orchestrator.md](/skills/templates/autonomous-orchestrator) | 自治编排器模板 |
|
||||||
| [templates/autonomous-action.md](templates/autonomous-action.md) | 自治动作模板 |
|
| [templates/autonomous-action.md](/skills/templates/autonomous-action) | 自治动作模板 |
|
||||||
|
|
||||||
**执行流程**:
|
**执行流程**:
|
||||||
```plaintext
|
```plaintext
|
||||||
|
|||||||
@@ -77,15 +77,15 @@
|
|||||||
**规范文档**（必读）:
|
**规范文档**（必读）:
|
||||||
| 文档 | 用途 | 优先级 |
|
| 文档 | 用途 | 优先级 |
|
||||||
|------|------|--------|
|
|------|------|--------|
|
||||||
| [specs/review-dimensions.md](specs/review-dimensions.md) | 审查维度定义和检查点 | **P0 - 最高** |
|
| [specs/review-dimensions.md](/skills/specs/review-dimensions) | 审查维度定义和检查点 | **P0 - 最高** |
|
||||||
| [specs/issue-classification.md](specs/issue-classification.md) | 问题分类和严重程度标准 | **P0 - 最高** |
|
| [specs/issue-classification.md](/skills/specs/issue-classification) | 问题分类和严重程度标准 | **P0 - 最高** |
|
||||||
| [specs/quality-standards.md](specs/quality-standards.md) | 审查质量标准 | P1 |
|
| [specs/quality-standards.md](/skills/specs/quality-standards) | 审查质量标准 | P1 |
|
||||||
|
|
||||||
**模板文件**（生成前必读）:
|
**模板文件**（生成前必读）:
|
||||||
| 文档 | 用途 |
|
| 文档 | 用途 |
|
||||||
|------|------|
|
|------|------|
|
||||||
| [templates/review-report.md](templates/review-report.md) | 审查报告模板 |
|
| [templates/review-report.md](/skills/templates/review-report) | 审查报告模板 |
|
||||||
| [templates/issue-template.md](templates/issue-template.md) | 问题记录模板 |
|
| [templates/issue-template.md](/skills/templates/issue-template) | 问题记录模板 |
|
||||||
|
|
||||||
**执行流程**:
|
**执行流程**:
|
||||||
```
|
```
|
||||||
@@ -234,5 +234,5 @@ const query = 'SELECT * FROM users WHERE username = ?';
|
|||||||
await db.query(query, [username]);
|
await db.query(query, [username]);
|
||||||
```
|
```
|
||||||
|
|
||||||
**Reference**: [specs/review-dimensions.md](specs/review-dimensions.md) - Security section
|
**Reference**: [specs/review-dimensions.md](/skills/specs/review-dimensions) - Security section
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -440,7 +440,7 @@ Explore → Document → Log → Analyze → Correct Understanding → Fix → V
|
|||||||
## 相关文档
|
## 相关文档
|
||||||
|
|
||||||
- [Claude Skills](./claude-index.md)
|
- [Claude Skills](./claude-index.md)
|
||||||
- [功能文档](../features/)
|
- [功能文档](../features/spec)
|
||||||
|
|
||||||
## 最佳实践
|
## 最佳实践
|
||||||
|
|
||||||
|
|||||||
@@ -171,5 +171,5 @@
|
|||||||
|
|
||||||
- [4级系统](./4-level.md) - 详细工作流说明
|
- [4级系统](./4-level.md) - 详细工作流说明
|
||||||
- [最佳实践](./best-practices.md) - 工作流优化技巧
|
- [最佳实践](./best-practices.md) - 工作流优化技巧
|
||||||
- [示例](./examples.md) - 工作流使用示例
|
- [示例](/workflows/examples) - 工作流使用示例
|
||||||
- [团队](./teams.md) - 团队工作流协调
|
- [团队](./teams.md) - 团队工作流协调
|
||||||
|
|||||||
Reference in New Issue
Block a user