mindforge-cc 2.0.0-alpha.9 → 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agent/CLAUDE.md +26 -0
- package/.agent/mindforge/add-backlog.md +32 -0
- package/.agent/mindforge/agent.md +31 -0
- package/.agent/mindforge/do.md +31 -0
- package/.agent/mindforge/execute-phase.md +23 -0
- package/.agent/mindforge/install-skill.md +20 -11
- package/.agent/mindforge/learn.md +142 -0
- package/.agent/mindforge/marketplace.md +120 -0
- package/.agent/mindforge/new-runtime.md +19 -0
- package/.agent/mindforge/note.md +35 -0
- package/.agent/mindforge/plant-seed.md +31 -0
- package/.agent/mindforge/remember.md +16 -4
- package/.agent/mindforge/review-backlog.md +34 -0
- package/.agent/mindforge/session-report.md +39 -0
- package/.agent/mindforge/ui-phase.md +34 -0
- package/.agent/mindforge/ui-review.md +36 -0
- package/.agent/mindforge/validate-phase.md +31 -0
- package/.agent/mindforge/workstreams.md +35 -0
- package/.claude/CLAUDE.md +26 -0
- package/.claude/commands/mindforge/add-backlog.md +32 -0
- package/.claude/commands/mindforge/agent.md +31 -0
- package/.claude/commands/mindforge/approve.md +27 -15
- package/.claude/commands/mindforge/audit.md +30 -26
- package/.claude/commands/mindforge/auto.md +29 -18
- package/.claude/commands/mindforge/benchmark.md +26 -29
- package/.claude/commands/mindforge/browse.md +24 -22
- package/.claude/commands/mindforge/complete-milestone.md +28 -14
- package/.claude/commands/mindforge/costs.md +26 -9
- package/.claude/commands/mindforge/cross-review.md +27 -13
- package/.claude/commands/mindforge/dashboard.md +35 -98
- package/.claude/commands/mindforge/debug.md +34 -126
- package/.claude/commands/mindforge/discuss-phase.md +36 -138
- package/.claude/commands/mindforge/do.md +31 -0
- package/.claude/commands/mindforge/execute-phase.md +37 -167
- package/.claude/commands/mindforge/health.md +27 -17
- package/.claude/commands/mindforge/help.md +25 -19
- package/.claude/commands/mindforge/init-org.md +37 -131
- package/.claude/commands/mindforge/init-project.md +40 -155
- package/.claude/commands/mindforge/install-skill.md +32 -15
- package/.claude/commands/mindforge/learn.md +36 -0
- package/.claude/commands/mindforge/map-codebase.md +36 -298
- package/.claude/commands/mindforge/marketplace.md +33 -0
- package/.claude/commands/mindforge/metrics.md +29 -18
- package/.claude/commands/mindforge/migrate.md +33 -40
- package/.claude/commands/mindforge/milestone.md +35 -12
- package/.claude/commands/mindforge/new-runtime.md +29 -0
- package/.claude/commands/mindforge/next.md +34 -105
- package/.claude/commands/mindforge/note.md +35 -0
- package/.claude/commands/mindforge/plan-phase.md +34 -125
- package/.claude/commands/mindforge/plant-seed.md +31 -0
- package/.claude/commands/mindforge/plugins.md +30 -36
- package/.claude/commands/mindforge/pr-review.md +32 -41
- package/.claude/commands/mindforge/profile-team.md +26 -19
- package/.claude/commands/mindforge/publish-skill.md +28 -17
- package/.claude/commands/mindforge/qa.md +27 -12
- package/.claude/commands/mindforge/quick.md +35 -135
- package/.claude/commands/mindforge/release.md +27 -8
- package/.claude/commands/mindforge/remember.md +25 -10
- package/.claude/commands/mindforge/research.md +27 -9
- package/.claude/commands/mindforge/retrospective.md +28 -22
- package/.claude/commands/mindforge/review-backlog.md +34 -0
- package/.claude/commands/mindforge/review.md +37 -157
- package/.claude/commands/mindforge/security-scan.md +34 -233
- package/.claude/commands/mindforge/session-report.md +39 -0
- package/.claude/commands/mindforge/ship.md +34 -100
- package/.claude/commands/mindforge/skills.md +36 -141
- package/.claude/commands/mindforge/status.md +30 -104
- package/.claude/commands/mindforge/steer.md +25 -10
- package/.claude/commands/mindforge/sync-confluence.md +28 -9
- package/.claude/commands/mindforge/sync-jira.md +32 -12
- package/.claude/commands/mindforge/tokens.md +25 -6
- package/.claude/commands/mindforge/ui-phase.md +34 -0
- package/.claude/commands/mindforge/ui-review.md +36 -0
- package/.claude/commands/mindforge/update.md +33 -42
- package/.claude/commands/mindforge/validate-phase.md +31 -0
- package/.claude/commands/mindforge/verify-phase.md +30 -62
- package/.claude/commands/mindforge/workspace.md +28 -25
- package/.claude/commands/mindforge/workstreams.md +35 -0
- package/.mindforge/distribution/marketplace.md +53 -0
- package/.mindforge/org/skills/MANIFEST.md +1 -0
- package/.mindforge/personas/advisor-researcher.md +89 -0
- package/.mindforge/personas/analyst.md +112 -52
- package/.mindforge/personas/architect.md +100 -67
- package/.mindforge/personas/assumptions-analyzer-extend.md +87 -0
- package/.mindforge/personas/assumptions-analyzer.md +109 -0
- package/.mindforge/personas/codebase-mapper-extend.md +93 -0
- package/.mindforge/personas/codebase-mapper.md +770 -0
- package/.mindforge/personas/coverage-specialist.md +104 -0
- package/.mindforge/personas/debug-specialist.md +118 -52
- package/.mindforge/personas/debugger.md +97 -0
- package/.mindforge/personas/decision-architect.md +102 -0
- package/.mindforge/personas/developer.md +97 -85
- package/.mindforge/personas/executor.md +88 -0
- package/.mindforge/personas/integration-checker.md +92 -0
- package/.mindforge/personas/nyquist-auditor.md +84 -0
- package/.mindforge/personas/phase-researcher.md +107 -0
- package/.mindforge/personas/plan-checker.md +92 -0
- package/.mindforge/personas/planner.md +105 -0
- package/.mindforge/personas/project-researcher.md +99 -0
- package/.mindforge/personas/qa-engineer.md +113 -61
- package/.mindforge/personas/release-manager.md +102 -64
- package/.mindforge/personas/research-agent.md +108 -24
- package/.mindforge/personas/research-synthesizer.md +101 -0
- package/.mindforge/personas/roadmapper-extend.md +100 -0
- package/.mindforge/personas/roadmapper.md +103 -0
- package/.mindforge/personas/security-reviewer.md +114 -91
- package/.mindforge/personas/tech-writer.md +118 -51
- package/.mindforge/personas/ui-auditor.md +94 -0
- package/.mindforge/personas/ui-checker.md +89 -0
- package/.mindforge/personas/ui-researcher.md +99 -0
- package/.mindforge/personas/user-profiler.md +93 -0
- package/.mindforge/personas/verifier.md +101 -0
- package/.mindforge/production/production-checklist.md +34 -123
- package/.mindforge/skills-builder/auto-capture-protocol.md +88 -0
- package/.mindforge/skills-builder/learn-protocol.md +161 -0
- package/.mindforge/skills-builder/quality-scoring.md +120 -0
- package/.planning/AUDIT.jsonl +1 -0
- package/.planning/decisions/ADR-036-learn-command-docs-as-skill-source.md +26 -0
- package/.planning/decisions/ADR-037-auto-capture-frequency-threshold.md +26 -0
- package/.planning/decisions/ADR-038-skill-quality-minimum-60.md +27 -0
- package/CHANGELOG.md +78 -0
- package/MINDFORGE.md +11 -0
- package/README.md +80 -6
- package/bin/autonomous/auto-runner.js +12 -0
- package/bin/install.js +8 -2
- package/bin/installer-core.js +129 -26
- package/bin/migrations/1.0.0-to-2.0.0.js +115 -0
- package/bin/migrations/schema-versions.js +12 -0
- package/bin/mindforge-cli.js +35 -0
- package/bin/review/cross-review-engine.js +11 -0
- package/bin/skill-registry.js +167 -0
- package/bin/skill-validator.js +144 -0
- package/bin/skills-builder/learn-cli.js +57 -0
- package/bin/skills-builder/marketplace-cli.js +54 -0
- package/bin/skills-builder/marketplace-client.js +198 -0
- package/bin/skills-builder/pattern-detector.js +144 -0
- package/bin/skills-builder/skill-generator.js +258 -0
- package/bin/skills-builder/skill-registrar.js +107 -0
- package/bin/skills-builder/skill-scorer.js +263 -0
- package/bin/skills-builder/source-loader.js +268 -0
- package/docs/Context/Master-Context.md +6 -13
- package/docs/PERSONAS.md +611 -0
- package/docs/architecture/README.md +6 -1
- package/docs/architecture/adr-039-multi-runtime-support.md +20 -0
- package/docs/architecture/adr-040-additive-schema-migration.md +21 -0
- package/docs/architecture/adr-041-stable-runtime-interface-contract.md +20 -0
- package/docs/architecture/decision-records-index.md +3 -0
- package/docs/commands-reference.md +3 -0
- package/docs/mindforge-md-reference.md +4 -0
- package/docs/reference/commands.md +53 -43
- package/docs/skills-authoring-guide.md +29 -0
- package/docs/skills-publishing-guide.md +3 -2
- package/docs/testing-current-version.md +3 -3
- package/docs/upgrade.md +16 -2
- package/docs/user-guide.md +57 -8
- package/docs/usp-features.md +21 -6
- package/package.json +1 -1
|
@@ -1,104 +1,30 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
If VERIFICATION.md is missing for a phase: label it "In progress" not "0% verified".
|
|
32
|
-
|
|
33
|
-
### Section 3 — Requirements coverage
|
|
34
|
-
Read REQUIREMENTS.md and count:
|
|
35
|
-
- Total v1 requirements
|
|
36
|
-
- Requirements with a passing test (from VERIFICATION.md files)
|
|
37
|
-
- Requirements implemented but untested
|
|
38
|
-
- Requirements not yet started
|
|
39
|
-
|
|
40
|
-
```
|
|
41
|
-
Requirements (v1)
|
|
42
|
-
───────────────────────────────────────────────────────
|
|
43
|
-
Total : [N]
|
|
44
|
-
✅ Done + tested : [N]
|
|
45
|
-
⚠️ Done, no test : [N]
|
|
46
|
-
🔴 Not started : [N]
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### Section 4 — Recent activity (from AUDIT.jsonl)
|
|
50
|
-
Read the last 10 entries from AUDIT.jsonl and display:
|
|
51
|
-
```
|
|
52
|
-
Recent Activity
|
|
53
|
-
───────────────────────────────────────────────────────
|
|
54
|
-
[timestamp] task_completed Plan 03: User API endpoints ✅
|
|
55
|
-
[timestamp] task_completed Plan 02: Product model ✅
|
|
56
|
-
[timestamp] task_started Plan 03: User API endpoints
|
|
57
|
-
[timestamp] task_completed Plan 01: User model ✅
|
|
58
|
-
[timestamp] context_compaction Phase 2, Plan 03 (72% context)
|
|
59
|
-
```
|
|
60
|
-
If AUDIT.jsonl is empty or missing, display:
|
|
61
|
-
```
|
|
62
|
-
Recent Activity
|
|
63
|
-
───────────────────────────────────────────────────────
|
|
64
|
-
No activity logged yet. Activity will appear here
|
|
65
|
-
after running /mindforge:execute-phase.
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
### Section 5 — Open issues
|
|
69
|
-
Check for:
|
|
70
|
-
- Any open SECURITY-REVIEW files with CRITICAL or HIGH findings
|
|
71
|
-
- Any BUGS.md files with open issues
|
|
72
|
-
- Any failed tasks in WAVE-REPORT files
|
|
73
|
-
- Any blockers in STATE.md
|
|
74
|
-
|
|
75
|
-
```
|
|
76
|
-
Open Issues
|
|
77
|
-
───────────────────────────────────────────────────────
|
|
78
|
-
🔴 CRITICAL: [if any — from SECURITY-REVIEW]
|
|
79
|
-
🟠 HIGH: [if any]
|
|
80
|
-
✅ No open issues
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
### Section 6 — Next action
|
|
84
|
-
```
|
|
85
|
-
Next Action
|
|
86
|
-
───────────────────────────────────────────────────────
|
|
87
|
-
[What STATE.md says the next action is]
|
|
88
|
-
Run: /mindforge:next
|
|
89
|
-
to auto-execute the next step.
|
|
90
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
## Data sources (in priority order)
|
|
94
|
-
1. STATE.md — authoritative for current status
|
|
95
|
-
2. AUDIT.jsonl — authoritative for history
|
|
96
|
-
3. REQUIREMENTS.md — authoritative for scope
|
|
97
|
-
4. VERIFICATION.md files — authoritative for test coverage
|
|
98
|
-
5. WAVE-REPORT files — authoritative for execution history
|
|
99
|
-
6. HANDOFF.json — authoritative for session state
|
|
100
|
-
|
|
101
|
-
## Performance notes
|
|
102
|
-
- For recent activity, read only the last 500 bytes of AUDIT.jsonl:
|
|
103
|
-
`tail -c 500 .planning/AUDIT.jsonl | [parse last complete JSON objects]`
|
|
104
|
-
- For requirement counts, count lines starting with `| FR-` instead of parsing the whole file.
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:status
|
|
3
|
+
description: Display a rich dashboard of the current project state
|
|
4
|
+
argument-hint: none
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- list_dir
|
|
7
|
+
- view_file
|
|
8
|
+
- run_command
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
<objective>
|
|
12
|
+
Provide a high-level visual summary of the project's health, progress, requirement coverage, and recent activity by synthesizing data from the `.planning/` directory.
|
|
13
|
+
</objective>
|
|
14
|
+
|
|
15
|
+
<execution_context>
|
|
16
|
+
.claude/commands/mindforge/status.md
|
|
17
|
+
</execution_context>
|
|
18
|
+
|
|
19
|
+
<context>
|
|
20
|
+
Sources: STATE.md, AUDIT.jsonl, REQUIREMENTS.md, and phase directories.
|
|
21
|
+
Focus: Real-time visibility into phase completion and open issues.
|
|
22
|
+
</context>
|
|
23
|
+
|
|
24
|
+
<process>
|
|
25
|
+
1. **Gather Phase Data**: Read `STATE.md` and calculate progress percentage for active/planned phases.
|
|
26
|
+
2. **Audit Requirements**: Count total, completed (verified), implemented (untested), and pending requirements from `REQUIREMENTS.md`.
|
|
27
|
+
3. **Extract Recent Activity**: Parse the last few entries of `AUDIT.jsonl` (using efficient tail read).
|
|
28
|
+
4. **Monitor Issues**: Check for critical security findings, open bugs, or execution blockers.
|
|
29
|
+
5. **Render Dashboard**: Display the multi-section summary including header, progress bars, requirement counts, and activity logs.
|
|
30
|
+
</process>
|
|
@@ -1,13 +1,28 @@
|
|
|
1
|
-
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:steer
|
|
3
|
+
description: Inject mid-execution guidance into the running autonomous engine
|
|
4
|
+
argument-hint: "[instruction]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- write_to_file
|
|
7
|
+
- view_file
|
|
8
|
+
---
|
|
2
9
|
|
|
3
|
-
|
|
4
|
-
|
|
10
|
+
<objective>
|
|
11
|
+
Provide a mechanism for human course-correction during long-running autonomous waves, allowing the user to redirect the agent's focus or update constraints without stopping the process.
|
|
12
|
+
</objective>
|
|
5
13
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
- `/mindforge:steer --cancel` (Clears the steering queue)
|
|
14
|
+
<execution_context>
|
|
15
|
+
.claude/commands/mindforge/steer.md
|
|
16
|
+
</execution_context>
|
|
10
17
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
18
|
+
<context>
|
|
19
|
+
Lifecycle: Applied at the next task boundary in `/mindforge:auto` mode.
|
|
20
|
+
Priority: Steering takes precedence over the original `PLAN.md` instructions.
|
|
21
|
+
</context>
|
|
22
|
+
|
|
23
|
+
<process>
|
|
24
|
+
1. **Queue Instruction**: Write the steering guidance to the active execution state.
|
|
25
|
+
2. **Target (Optional)**: Explicitly target a future task ID for modification.
|
|
26
|
+
3. **Validate**: Ensure steering does not violate core security or governance gates.
|
|
27
|
+
4. **Cancel**: Clear the steering queue if instructions are no longer relevant.
|
|
28
|
+
</process>
|
|
@@ -1,11 +1,30 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:sync-confluence
|
|
3
|
+
description: Publish approved planning artifacts to Confluence
|
|
4
|
+
argument-hint: [--architecture] [--phase N] [--milestone name]
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- run_command
|
|
7
|
+
- view_file
|
|
8
|
+
- write_to_file
|
|
9
|
+
---
|
|
3
10
|
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
- never publish secrets, raw approval notes, or raw audit logs
|
|
8
|
-
- log success, skip, or failure to AUDIT
|
|
11
|
+
<objective>
|
|
12
|
+
Automate the publication of key project documentation and architectural decisions to Confluence, providing a durable and searchable record for the broader organization.
|
|
13
|
+
</objective>
|
|
9
14
|
|
|
10
|
-
|
|
11
|
-
|
|
15
|
+
<execution_context>
|
|
16
|
+
.claude/commands/mindforge/sync-confluence.md
|
|
17
|
+
</execution_context>
|
|
18
|
+
|
|
19
|
+
<context>
|
|
20
|
+
Auth: Managed via `connection-manager.md`.
|
|
21
|
+
Exclusion: Secrets, raw logs, and PII are strictly filtered before publication.
|
|
22
|
+
</context>
|
|
23
|
+
|
|
24
|
+
<process>
|
|
25
|
+
1. **Assemble Content**: Gather target artifacts (ARCHITECTURE.md, Phase Plans, Milestone reports).
|
|
26
|
+
2. **Filter & Sanitize**: Remove all sensitive data (passwords, tokens, raw audit trails).
|
|
27
|
+
3. **Publish**: Update existing pages or create new ones in the specified Confluence space.
|
|
28
|
+
4. **Indempotency**: Match pages by title or project-wide ID to avoid duplication.
|
|
29
|
+
5. **Audit**: Log publication success or skipped files.
|
|
30
|
+
</process>
|
|
@@ -1,12 +1,32 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
-
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:sync-jira
|
|
3
|
+
description: Synchronize MindForge phase and plan metadata to Jira
|
|
4
|
+
argument-hint: [--phase N] [--plan M]
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- run_command
|
|
7
|
+
- view_file
|
|
8
|
+
- write_to_file
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
<objective>
|
|
12
|
+
Maintain parity between local MindForge planning state and the enterprise Jira issue tracker, ensuring stakeholders have visibility into phase progress and task status.
|
|
13
|
+
</objective>
|
|
14
|
+
|
|
15
|
+
<execution_context>
|
|
16
|
+
.claude/commands/mindforge/sync-jira.md
|
|
17
|
+
</execution_context>
|
|
18
|
+
|
|
19
|
+
<context>
|
|
20
|
+
Metadata: .planning/jira-sync.json
|
|
21
|
+
Auth: Managed via `connection-manager.md`.
|
|
22
|
+
Resilience: Failures are non-fatal; state is logged in `STATE.md` for retry.
|
|
23
|
+
</context>
|
|
24
|
+
|
|
25
|
+
<process>
|
|
26
|
+
1. **Verify Connection**: Ensure Jira API availability and auth tokens are valid.
|
|
27
|
+
2. **Resolve Mappings**: Map Phase and Plan IDs to Jira Epics and Stories.
|
|
28
|
+
3. **Transition Issues**: Update Jira statuses based on verification results (e.g., Verified -> Done).
|
|
29
|
+
4. **Sync Content**: Push plan descriptions and requirements to the relevant Jira tickets.
|
|
30
|
+
5. **Preserve Manual Edits**: Avoid overwriting manual comments or fields in Jira.
|
|
31
|
+
6. **Audit**: Log the sync event with counts of updated and created tickets.
|
|
32
|
+
</process>
|
|
@@ -1,8 +1,27 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:tokens
|
|
3
|
+
description: Analyze token consumption profile and efficiency
|
|
4
|
+
argument-hint: [--phase N] [--session ID] [--window short|medium|long] [--optimise]
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- view_file
|
|
7
|
+
- run_command
|
|
8
|
+
---
|
|
3
9
|
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
10
|
+
<objective>
|
|
11
|
+
Deeply analyze how tokens are being consumed across the project to identify waste, improve prompt efficiency, and optimize context budgeting.
|
|
12
|
+
</objective>
|
|
7
13
|
|
|
8
|
-
|
|
14
|
+
<execution_context>
|
|
15
|
+
.claude/commands/mindforge/tokens.md
|
|
16
|
+
</execution_context>
|
|
17
|
+
|
|
18
|
+
<context>
|
|
19
|
+
Analysis Focus: Input vs Output tokens, cache hits/misses, compaction efficiency.
|
|
20
|
+
</context>
|
|
21
|
+
|
|
22
|
+
<process>
|
|
23
|
+
1. **Fetch Profiles**: Read token usage data for the specified scope.
|
|
24
|
+
2. **Identify Waste**: Detect large, repetitive context injections or missed cache opportunities.
|
|
25
|
+
3. **Optimization Advice**: If `--optimise` is set, provide specific recommendations (e.g., "Summarize ARCHITECTURE.md to save 2k tokens/session").
|
|
26
|
+
4. **Report**: Display the token consumption profile and efficiency score.
|
|
27
|
+
</process>
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:ui-phase
|
|
3
|
+
description: Generate a UI Design Contract (UI-SPEC.md) for the current phase
|
|
4
|
+
argument-hint: [N]
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- view_file
|
|
7
|
+
- write_to_file
|
|
8
|
+
- list_dir
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
<objective>
|
|
12
|
+
Generate a detailed UI design contract (UI-SPEC.md) for a frontend development phase to ensure consistent spacing, typography, color palettes, and accessibility standards before implementation.
|
|
13
|
+
</objective>
|
|
14
|
+
|
|
15
|
+
<execution_context>
|
|
16
|
+
.claude/commands/mindforge/ui-phase.md
|
|
17
|
+
</execution_context>
|
|
18
|
+
|
|
19
|
+
<context>
|
|
20
|
+
Arguments: $ARGUMENTS (The phase number [N], optional)
|
|
21
|
+
Configuration: MINDFORGE.md `UI_PHASE_ACCESSIBILITY_STANDARD`
|
|
22
|
+
State: Resolves the phase from STATE.md if N is not provided.
|
|
23
|
+
</context>
|
|
24
|
+
|
|
25
|
+
<process>
|
|
26
|
+
1. **Identify Phase**: Get the current or targeted phase number.
|
|
27
|
+
2. **Read Inputs**: Read `REQUIREMENTS.md` and `DESIGN_SYSTEM.md`.
|
|
28
|
+
3. **Generate UI-SPEC.md**:
|
|
29
|
+
- Define component-level spacing and layout for the phase.
|
|
30
|
+
- Specify required colors and typography from the design system.
|
|
31
|
+
- List accessibility requirements (WCAG level).
|
|
32
|
+
4. **Finalize**: Write `UI-SPEC.md` to the phase's planning directory or the root `.planning/`.
|
|
33
|
+
5. **Confirm**: Provide a link to the user for review.
|
|
34
|
+
</process>
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:ui-review
|
|
3
|
+
description: Perform a retroactive visual audit of implemented UI against the DESIGN_SYSTEM.md and UI-SPEC.md
|
|
4
|
+
argument-hint: [N]
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- view_file
|
|
7
|
+
- write_to_file
|
|
8
|
+
- read_browser_page
|
|
9
|
+
- open_browser_url
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<objective>
|
|
13
|
+
Perform a retroactive, multi-pillar visual audit of implemented UI features against the defined Design System and UI-SPEC.md to ensure pixel-perfect fidelity and accessibility compliance.
|
|
14
|
+
</objective>
|
|
15
|
+
|
|
16
|
+
<execution_context>
|
|
17
|
+
.claude/commands/mindforge/ui-review.md
|
|
18
|
+
</execution_context>
|
|
19
|
+
|
|
20
|
+
<context>
|
|
21
|
+
Arguments: $ARGUMENTS (The phase number [N], optional)
|
|
22
|
+
Sources: `DESIGN_SYSTEM.md`, `UI-SPEC.md`, and the live application UI.
|
|
23
|
+
</context>
|
|
24
|
+
|
|
25
|
+
<process>
|
|
26
|
+
1. **Identify Target**: Determine the phase to review.
|
|
27
|
+
2. **Audit Application**:
|
|
28
|
+
- Use the browser tool to inspect the implemented features.
|
|
29
|
+
- Compare against the `UI-SPEC.md` for spacing, colors, and layout.
|
|
30
|
+
- Audit for accessibility (ARIA labels, contrast, keyboard navigation).
|
|
31
|
+
3. **Generate UI-REVIEW.md**:
|
|
32
|
+
- Grade each pillar (Layout, Color, Typography, etc.).
|
|
33
|
+
- List specific "Needs Work" items.
|
|
34
|
+
- Provide "Approved" status if all criteria are met.
|
|
35
|
+
4. **Finalize**: Notify the user of the audit results.
|
|
36
|
+
</process>
|
|
@@ -1,42 +1,33 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
| Error | Recovery |
|
|
36
|
-
|---|---|
|
|
37
|
-
| npm registry unreachable | Message: "Check internet. Manual: npm info mindforge-cc version" |
|
|
38
|
-
| Update download fails | Retry once, then suggest manual: `npx mindforge-cc@latest` |
|
|
39
|
-
| Migration fails | Restored from backup automatically. Run /mindforge:migrate manually. |
|
|
40
|
-
| Install scope detection fails | Prompt user: "Is your install global or local?" |
|
|
41
|
-
|
|
42
|
-
## AUDIT entry
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:update
|
|
3
|
+
description: Safely check for and apply MindForge framework updates
|
|
4
|
+
argument-hint: [--apply] [--force] [--check] [--skip-changelog]
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- run_command
|
|
7
|
+
- view_file
|
|
8
|
+
- write_to_file
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
<objective>
|
|
12
|
+
Keep the project's MindForge installation up to date with the latest features, bug fixes, and security patches while ensuring no data loss or architectural regression.
|
|
13
|
+
</objective>
|
|
14
|
+
|
|
15
|
+
<execution_context>
|
|
16
|
+
.claude/commands/mindforge/update.md
|
|
17
|
+
</execution_context>
|
|
18
|
+
|
|
19
|
+
<context>
|
|
20
|
+
Platform: bin/updater/self-update.js
|
|
21
|
+
Scope: Local vs. Global detection.
|
|
22
|
+
Security: Enforces schema migration during the update process.
|
|
23
|
+
</context>
|
|
24
|
+
|
|
25
|
+
<process>
|
|
26
|
+
1. **Check**: Query the registry for the latest version and compare with the current installation.
|
|
27
|
+
2. **Changelog**: Display relevant updates, highlighting **BREAKING CHANGES** for major versions.
|
|
28
|
+
3. **Pre-update State**: Capture the `schema_version` from HANDOFF.json.
|
|
29
|
+
4. **Apply**: If `--apply` is set, download and install the new version into the detected scope.
|
|
30
|
+
5. **Migrate**: Run `/mindforge:migrate` to reconcile the project schema with the new framework version.
|
|
31
|
+
6. **Verify**: Run `/mindforge:health` to confirm the update succeeded without introducing errors.
|
|
32
|
+
7. **Audit**: Log `update_completed` with the jump range (X.Y.Z -> A.B.C).
|
|
33
|
+
</process>
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:validate-phase
|
|
3
|
+
description: Audit the current phase for requirement coverage and test gaps
|
|
4
|
+
argument-hint: [N]
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- view_file
|
|
7
|
+
- list_dir
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
<objective>
|
|
11
|
+
Audit a completed project phase to ensure every requirement has been addressed and that corresponding automated tests have been implemented and are passing.
|
|
12
|
+
</objective>
|
|
13
|
+
|
|
14
|
+
<execution_context>
|
|
15
|
+
.claude/commands/mindforge/validate-phase.md
|
|
16
|
+
</execution_context>
|
|
17
|
+
|
|
18
|
+
<context>
|
|
19
|
+
Arguments: $ARGUMENTS (The phase number [N], optional)
|
|
20
|
+
Knowledge: `STATE.md`, `REQUIREMENTS.md`, and the codebase test suite.
|
|
21
|
+
</context>
|
|
22
|
+
|
|
23
|
+
<process>
|
|
24
|
+
1. **Identify Phase**: Resolve the targeted phase.
|
|
25
|
+
2. **Cross-reference**:
|
|
26
|
+
- List all requirements in `REQUIREMENTS.md` marked for this phase.
|
|
27
|
+
- Verify implementation of each requirement in the code.
|
|
28
|
+
- Check for the existence of passing tests for each requirement.
|
|
29
|
+
3. **Analyze Gaps**: Identify any "orphaned" requirements or features missing tests.
|
|
30
|
+
4. **Report Findings**: Summarize coverage and call out specific gaps to the user.
|
|
31
|
+
</process>
|
|
@@ -1,62 +1,30 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
4.
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
## Step 4 — Write UAT record
|
|
32
|
-
Write `.planning/phases/[N]/UAT.md`:
|
|
33
|
-
|
|
34
|
-
```markdown
|
|
35
|
-
# UAT — Phase [N]
|
|
36
|
-
|
|
37
|
-
## Tester
|
|
38
|
-
[User name or "developer"]
|
|
39
|
-
|
|
40
|
-
## Date
|
|
41
|
-
[ISO 8601 date]
|
|
42
|
-
|
|
43
|
-
## Results
|
|
44
|
-
|
|
45
|
-
| # | Deliverable | Result | Notes |
|
|
46
|
-
|---|------------------------------------|--------|------------------------|
|
|
47
|
-
| 1 | [description] | ✅ | [what was observed] |
|
|
48
|
-
| 2 | [description] | ❌ | [what went wrong] |
|
|
49
|
-
|
|
50
|
-
## Overall status
|
|
51
|
-
All passed ✅ / Issues found — fix plans created ❌
|
|
52
|
-
|
|
53
|
-
## Sign-off
|
|
54
|
-
[Passed / Pending fixes]
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
## Step 5 — Update state if all pass
|
|
58
|
-
If all deliverables pass:
|
|
59
|
-
Update STATE.md: phase N = verified and signed off.
|
|
60
|
-
Tell the user:
|
|
61
|
-
"✅ Phase [N] verified and signed off.
|
|
62
|
-
Run /mindforge:ship [N] to create the release PR."
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:verify-phase
|
|
3
|
+
description: Human acceptance testing (UAT) for a completed phase
|
|
4
|
+
argument-hint: [N]
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- view_file
|
|
7
|
+
- write_to_file
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
<objective>
|
|
11
|
+
Conduct a structured User Acceptance Testing (UAT) session for a completed phase, gathering human feedback on deliverables and identifying any required fixes.
|
|
12
|
+
</objective>
|
|
13
|
+
|
|
14
|
+
<execution_context>
|
|
15
|
+
.claude/commands/mindforge/verify-phase.md
|
|
16
|
+
</execution_context>
|
|
17
|
+
|
|
18
|
+
<context>
|
|
19
|
+
Arguments: $ARGUMENTS (Phase N)
|
|
20
|
+
Prerequisite: .planning/phases/[N]/VERIFICATION.md must exist.
|
|
21
|
+
Output: .planning/phases/[N]/UAT.md
|
|
22
|
+
</context>
|
|
23
|
+
|
|
24
|
+
<process>
|
|
25
|
+
1. **Extract Deliverables**: Read requirements and plans to generate a list of checkable instructions for the user.
|
|
26
|
+
2. **Interactive Walkthrough**: Present deliverables one at a time and ask the user for Pass/Fail status and observations.
|
|
27
|
+
3. **Handle Failures**: If a task fails, spawn a debug subagent and create a `FIX-PLAN-[N]-[NN].md`.
|
|
28
|
+
4. **Record Results**: Write `UAT.md` capturing testers, dates, results per deliverable, and overall sign-off status.
|
|
29
|
+
5. **Update State**: If all pass, mark phase as verified in `STATE.md` and guide the user to `/mindforge:ship`.
|
|
30
|
+
</process>
|
|
@@ -1,29 +1,32 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
---
|
|
2
|
+
name: mindforge:workspace
|
|
3
|
+
description: Manage monorepo workspaces and cross-package dependencies
|
|
4
|
+
argument-hint: [detect|list|plan phase N|test]
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- run_command
|
|
7
|
+
- list_dir
|
|
8
|
+
- view_file
|
|
9
|
+
- write_to_file
|
|
10
|
+
---
|
|
3
11
|
|
|
4
|
-
|
|
12
|
+
<objective>
|
|
13
|
+
Enable seamless development within monorepo environments by detecting package structures, managing cross-package dependencies, and coordinating multi-package phase planning and testing.
|
|
14
|
+
</objective>
|
|
5
15
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
Report: workspace type, packages found, dependency order.
|
|
16
|
+
<execution_context>
|
|
17
|
+
.claude/commands/mindforge/workspace.md
|
|
18
|
+
</execution_context>
|
|
10
19
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
apps/api → @myapp/api (api, depends on: shared)
|
|
17
|
-
apps/web → @myapp/web (web, depends on: shared, api)
|
|
18
|
-
apps/mobile → @myapp/mobile (mobile, depends on: shared)
|
|
19
|
-
Execution order: shared → api → (web, mobile in parallel)
|
|
20
|
-
```
|
|
20
|
+
<context>
|
|
21
|
+
Metadata: WORKSPACE-MANIFEST.json
|
|
22
|
+
Engine: workspace-detector.md, cross-package-planner.md
|
|
23
|
+
Subcommands: detect, list, plan, test.
|
|
24
|
+
</context>
|
|
21
25
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
Report per-package test results and aggregate coverage.
|
|
26
|
+
<process>
|
|
27
|
+
1. **Detect**: Run the workspace detector to identify the monorepo type and generate `WORKSPACE-MANIFEST.json`.
|
|
28
|
+
2. **List**: Present a structured view of all packages, their types, and dependency relationships.
|
|
29
|
+
3. **Plan**: Generate a phase plan that spans multiple packages, ensuring execution follows the correct dependency order.
|
|
30
|
+
4. **Test**: Execute the test suite for all packages in the correct topological order and aggregate results.
|
|
31
|
+
5. **Confirm**: Update the user on workspace health and detected configurations.
|
|
32
|
+
</process>
|