mindforge-cc 11.8.2 → 11.9.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/mindforge/wf-orchestrate-review.md +35 -0
- package/.agent/mindforge/wf-verification-loop.md +45 -0
- package/.agent/mindforge/wf-workflow-optimizer.md +51 -0
- package/.agent/skills/article-illustrator/SKILL.md +7 -7
- package/.agent/skills/arxiv/SKILL.md +6 -6
- package/.agent/skills/code-wiki/SKILL.md +11 -11
- package/.agent/skills/concept-diagrams/SKILL.md +6 -6
- package/.agent/skills/concept-diagrams/examples/apartment-floor-plan-conversion.md +244 -0
- package/.agent/skills/concept-diagrams/examples/automated-password-reset-flow.md +276 -0
- package/.agent/skills/concept-diagrams/examples/autonomous-llm-research-agent-flow.md +240 -0
- package/.agent/skills/concept-diagrams/examples/banana-journey-tree-to-smoothie.md +161 -0
- package/.agent/skills/concept-diagrams/examples/commercial-aircraft-structure.md +209 -0
- package/.agent/skills/concept-diagrams/examples/cpu-ooo-microarchitecture.md +236 -0
- package/.agent/skills/concept-diagrams/examples/electricity-grid-flow.md +182 -0
- package/.agent/skills/concept-diagrams/examples/feature-film-production-pipeline.md +172 -0
- package/.agent/skills/concept-diagrams/examples/hospital-emergency-department-flow.md +165 -0
- package/.agent/skills/concept-diagrams/examples/ml-benchmark-grouped-bar-chart.md +114 -0
- package/.agent/skills/concept-diagrams/examples/place-order-uml-sequence.md +325 -0
- package/.agent/skills/concept-diagrams/examples/smart-city-infrastructure.md +173 -0
- package/.agent/skills/concept-diagrams/examples/smartphone-layer-anatomy.md +154 -0
- package/.agent/skills/concept-diagrams/examples/sn2-reaction-mechanism.md +247 -0
- package/.agent/skills/concept-diagrams/examples/wind-turbine-structure.md +338 -0
- package/.agent/skills/concept-diagrams/templates/template.html +174 -0
- package/.agent/skills/domain-intel/SKILL.md +7 -7
- package/.agent/skills/duckduckgo-search/SKILL.md +17 -17
- package/.agent/skills/github-auth/scripts/gh-env.sh +66 -0
- package/.agent/skills/github-code-review/SKILL.md +9 -9
- package/.agent/skills/github-pr-workflow/SKILL.md +3 -3
- package/.agent/skills/godmode/SKILL.md +8 -8
- package/.agent/skills/jupyter-live-kernel/SKILL.md +3 -3
- package/.agent/skills/kanban-orchestrator/SKILL.md +10 -10
- package/.agent/skills/kanban-worker/SKILL.md +6 -6
- package/.agent/skills/llm-wiki/SKILL.md +7 -7
- package/.agent/skills/mindforge-autonomous/SKILL.md +1 -1
- package/.agent/skills/mindforge-complete-milestone/SKILL.md +1 -1
- package/.agent/skills/mindforge-discuss-phase/SKILL.md +1 -1
- package/.agent/skills/mindforge-do/SKILL.md +1 -1
- package/.agent/skills/mindforge-execute-phase/SKILL.md +1 -1
- package/.agent/skills/mindforge-list-workspaces/SKILL.md +1 -1
- package/.agent/skills/mindforge-manager/SKILL.md +1 -1
- package/.agent/skills/mindforge-neural-orchestrator/SKILL.md +1 -1
- package/.agent/skills/mindforge-new-milestone/SKILL.md +4 -4
- package/.agent/skills/mindforge-new-project/SKILL.md +4 -4
- package/.agent/skills/mindforge-new-workspace/SKILL.md +1 -1
- package/.agent/skills/mindforge-note/SKILL.md +1 -1
- package/.agent/skills/mindforge-plan-phase/SKILL.md +1 -1
- package/.agent/skills/mindforge-profile-user/SKILL.md +1 -1
- package/.agent/skills/mindforge-remove-workspace/SKILL.md +1 -1
- package/.agent/skills/mindforge-research-phase/SKILL.md +1 -1
- package/.agent/skills/mindforge-ui-phase/SKILL.md +1 -1
- package/.agent/skills/mindforge-ui-review/SKILL.md +1 -1
- package/.agent/skills/mindforge-verify-work/SKILL.md +1 -1
- package/.agent/skills/mindforge-workspace-isolated/SKILL.md +1 -1
- package/.agent/skills/node-inspect-debugger/SKILL.md +1 -1
- package/.agent/skills/obsidian/SKILL.md +15 -15
- package/.agent/skills/osint-investigation/SKILL.md +3 -2
- package/.agent/skills/osint-investigation/references/sources/courtlistener.md +98 -0
- package/.agent/skills/osint-investigation/references/sources/gdelt.md +104 -0
- package/.agent/skills/osint-investigation/references/sources/icij-offshore.md +104 -0
- package/.agent/skills/osint-investigation/references/sources/nyc-acris.md +90 -0
- package/.agent/skills/osint-investigation/references/sources/ofac-sdn.md +92 -0
- package/.agent/skills/osint-investigation/references/sources/opencorporates.md +103 -0
- package/.agent/skills/osint-investigation/references/sources/sec-edgar.md +83 -0
- package/.agent/skills/osint-investigation/references/sources/senate-ld.md +89 -0
- package/.agent/skills/osint-investigation/references/sources/usaspending.md +97 -0
- package/.agent/skills/osint-investigation/references/sources/wayback.md +93 -0
- package/.agent/skills/osint-investigation/references/sources/wikipedia.md +107 -0
- package/.agent/skills/osint-investigation/scripts/_http.py +82 -0
- package/.agent/skills/osint-investigation/scripts/_normalize.py +67 -0
- package/.agent/skills/osint-investigation/scripts/build_findings.py +221 -0
- package/.agent/skills/osint-investigation/scripts/entity_resolution.py +228 -0
- package/.agent/skills/osint-investigation/scripts/fetch_courtlistener.py +149 -0
- package/.agent/skills/osint-investigation/scripts/fetch_gdelt.py +161 -0
- package/.agent/skills/osint-investigation/scripts/fetch_icij_offshore.py +234 -0
- package/.agent/skills/osint-investigation/scripts/fetch_nyc_acris.py +203 -0
- package/.agent/skills/osint-investigation/scripts/fetch_ofac_sdn.py +175 -0
- package/.agent/skills/osint-investigation/scripts/fetch_opencorporates.py +191 -0
- package/.agent/skills/osint-investigation/scripts/fetch_sec_edgar.py +184 -0
- package/.agent/skills/osint-investigation/scripts/fetch_senate_ld.py +146 -0
- package/.agent/skills/osint-investigation/scripts/fetch_usaspending.py +170 -0
- package/.agent/skills/osint-investigation/scripts/fetch_wayback.py +142 -0
- package/.agent/skills/osint-investigation/scripts/fetch_wikipedia.py +266 -0
- package/.agent/skills/osint-investigation/scripts/timing_analysis.py +252 -0
- package/.agent/skills/oss-forensics/SKILL.md +10 -9
- package/.agent/skills/oss-forensics/scripts/evidence-store.py +313 -0
- package/.agent/skills/parallel-cli/SKILL.md +2 -2
- package/.agent/skills/pinggy-tunnel/SKILL.md +3 -3
- package/.agent/skills/pixel-art/SKILL.md +2 -2
- package/.agent/skills/plan/SKILL.md +10 -10
- package/.agent/skills/requesting-code-review/SKILL.md +4 -6
- package/.agent/skills/research-paper-writing/SKILL.md +32 -32
- package/.agent/skills/rest-graphql-debug/SKILL.md +31 -32
- package/.agent/skills/s6-container-supervision/SKILL.md +1 -1
- package/.agent/skills/scrapling/SKILL.md +1 -1
- package/.agent/skills/sherlock/SKILL.md +1 -1
- package/.agent/skills/simplify-code/SKILL.md +5 -7
- package/.agent/skills/skill-authoring/SKILL.md +4 -4
- package/.agent/skills/spike/SKILL.md +11 -13
- package/.agent/skills/subagent-driven-development/SKILL.md +7 -11
- package/.agent/skills/systematic-debugging/SKILL.md +13 -14
- package/.agent/skills/test-driven-development/SKILL.md +6 -7
- package/.agent/skills/video-orchestrator/SKILL.md +1 -1
- package/.agent/skills/web-pentest/SKILL.md +7 -7
- package/.mindforge/config.json +3 -2
- package/.mindforge/dynamic-workflows/REGISTRY.md +4 -1
- package/.mindforge/dynamic-workflows/index.json +910 -840
- package/.mindforge/dynamic-workflows/scripts/accessibility-audit.js +88 -90
- package/.mindforge/dynamic-workflows/scripts/ai-model-eval.js +59 -61
- package/.mindforge/dynamic-workflows/scripts/api-contract-test.js +87 -85
- package/.mindforge/dynamic-workflows/scripts/api-migration.js +120 -122
- package/.mindforge/dynamic-workflows/scripts/architecture-modernization.js +84 -86
- package/.mindforge/dynamic-workflows/scripts/code-audit.js +75 -77
- package/.mindforge/dynamic-workflows/scripts/code-explainer.js +99 -101
- package/.mindforge/dynamic-workflows/scripts/competitive-analysis.js +62 -64
- package/.mindforge/dynamic-workflows/scripts/competitive-teardown.js +106 -108
- package/.mindforge/dynamic-workflows/scripts/cost-analysis.js +78 -80
- package/.mindforge/dynamic-workflows/scripts/data-pipeline-validate.js +47 -49
- package/.mindforge/dynamic-workflows/scripts/database-migration.js +85 -87
- package/.mindforge/dynamic-workflows/scripts/debug-detective.js +97 -99
- package/.mindforge/dynamic-workflows/scripts/dependency-health.js +81 -83
- package/.mindforge/dynamic-workflows/scripts/design-system-audit.js +84 -86
- package/.mindforge/dynamic-workflows/scripts/documentation-gen.js +65 -67
- package/.mindforge/dynamic-workflows/scripts/feature-planner.js +78 -80
- package/.mindforge/dynamic-workflows/scripts/incident-response.js +81 -83
- package/.mindforge/dynamic-workflows/scripts/multi-repo-sync.js +49 -51
- package/.mindforge/dynamic-workflows/scripts/mutation-testing.js +113 -115
- package/.mindforge/dynamic-workflows/scripts/onboard-codebase.js +79 -81
- package/.mindforge/dynamic-workflows/scripts/orchestrate-review.js +115 -0
- package/.mindforge/dynamic-workflows/scripts/perf-optimize.js +97 -99
- package/.mindforge/dynamic-workflows/scripts/pr-review.js +61 -63
- package/.mindforge/dynamic-workflows/scripts/refactor-plan.js +88 -90
- package/.mindforge/dynamic-workflows/scripts/release-prep.js +79 -81
- package/.mindforge/dynamic-workflows/scripts/security-hardening.js +117 -119
- package/.mindforge/dynamic-workflows/scripts/security-threat-model.js +119 -121
- package/.mindforge/dynamic-workflows/scripts/tdd-sprint.js +80 -82
- package/.mindforge/dynamic-workflows/scripts/tech-evaluation.js +50 -52
- package/.mindforge/dynamic-workflows/scripts/test-coverage-gap.js +68 -70
- package/.mindforge/dynamic-workflows/scripts/ux-heuristic-audit.js +89 -91
- package/.mindforge/dynamic-workflows/scripts/verification-loop.js +138 -0
- package/.mindforge/dynamic-workflows/scripts/workflow-optimizer.js +136 -0
- package/.mindforge/dynamic-workflows/scripts/writer-reviewer.js +63 -65
- package/.mindforge/memory/sync-manifest.json +1 -1
- package/.mindforge/personas/advisor-researcher.md +2 -2
- package/.mindforge/personas/api-load-tester.md +1 -1
- package/.mindforge/personas/authentication-architect.md +1 -1
- package/.mindforge/personas/backup-recovery-specialist.md +1 -1
- package/.mindforge/personas/build-optimizer.md +1 -1
- package/.mindforge/personas/caching-strategist.md +1 -1
- package/.mindforge/personas/chaos-engineer.md +1 -1
- package/.mindforge/personas/compliance-auditor.md +1 -1
- package/.mindforge/personas/config-management-expert.md +1 -1
- package/.mindforge/personas/coverage-specialist.md +1 -1
- package/.mindforge/personas/debug-specialist.md +2 -2
- package/.mindforge/personas/debugger.md +2 -2
- package/.mindforge/personas/dependency-auditor.md +1 -1
- package/.mindforge/personas/developer.md +1 -1
- package/.mindforge/personas/devops-engineer.md +1 -1
- package/.mindforge/personas/executor.md +1 -1
- package/.mindforge/personas/go-specialist.md +1 -1
- package/.mindforge/personas/incident-commander.md +1 -1
- package/.mindforge/personas/java-specialist.md +1 -1
- package/.mindforge/personas/kubernetes-debugger.md +1 -1
- package/.mindforge/personas/logging-architect.md +1 -1
- package/.mindforge/personas/mf-planner.md +1 -1
- package/.mindforge/personas/mf-researcher.md +1 -1
- package/.mindforge/personas/mf-reviewer.md +1 -1
- package/.mindforge/personas/nyquist-auditor.md +1 -1
- package/.mindforge/personas/observability-engineer.md +1 -1
- package/.mindforge/personas/performance-optimizer.md +1 -1
- package/.mindforge/personas/phase-researcher.md +5 -5
- package/.mindforge/personas/planner.md +1 -1
- package/.mindforge/personas/project-researcher.md +2 -2
- package/.mindforge/personas/python-specialist.md +1 -1
- package/.mindforge/personas/qa-engineer.md +1 -1
- package/.mindforge/personas/release-manager.md +1 -1
- package/.mindforge/personas/research-agent.md +4 -4
- package/.mindforge/personas/roadmapper-extend.md +1 -1
- package/.mindforge/personas/rust-specialist.md +1 -1
- package/.mindforge/personas/security-reviewer.md +1 -1
- package/.mindforge/personas/tech-writer.md +1 -1
- package/.mindforge/personas/typescript-wizard.md +1 -1
- package/.mindforge/personas/ui-researcher.md +1 -1
- package/.mindforge/skills/accessibility/SKILL.md +3 -3
- package/.mindforge/skills/agent-architecture-audit/SKILL.md +11 -0
- package/.mindforge/skills/agent-loops/SKILL.md +1 -1
- package/.mindforge/skills/arxiv/SKILL.md +6 -6
- package/.mindforge/skills/arxiv/scripts/search_arxiv.py +114 -0
- package/.mindforge/skills/code-tour/SKILL.md +2 -2
- package/.mindforge/skills/code-wiki/SKILL.md +11 -11
- package/.mindforge/skills/code-wiki/templates/README.md +31 -0
- package/.mindforge/skills/code-wiki/templates/architecture.md +30 -0
- package/.mindforge/skills/code-wiki/templates/getting-started.md +47 -0
- package/.mindforge/skills/code-wiki/templates/module.md +38 -0
- package/.mindforge/skills/concept-diagrams/SKILL.md +6 -6
- package/.mindforge/skills/concept-diagrams/examples/apartment-floor-plan-conversion.md +244 -0
- package/.mindforge/skills/concept-diagrams/examples/automated-password-reset-flow.md +276 -0
- package/.mindforge/skills/concept-diagrams/examples/autonomous-llm-research-agent-flow.md +240 -0
- package/.mindforge/skills/concept-diagrams/examples/banana-journey-tree-to-smoothie.md +161 -0
- package/.mindforge/skills/concept-diagrams/examples/commercial-aircraft-structure.md +209 -0
- package/.mindforge/skills/concept-diagrams/examples/cpu-ooo-microarchitecture.md +236 -0
- package/.mindforge/skills/concept-diagrams/examples/electricity-grid-flow.md +182 -0
- package/.mindforge/skills/concept-diagrams/examples/feature-film-production-pipeline.md +172 -0
- package/.mindforge/skills/concept-diagrams/examples/hospital-emergency-department-flow.md +165 -0
- package/.mindforge/skills/concept-diagrams/examples/ml-benchmark-grouped-bar-chart.md +114 -0
- package/.mindforge/skills/concept-diagrams/examples/place-order-uml-sequence.md +325 -0
- package/.mindforge/skills/concept-diagrams/examples/smart-city-infrastructure.md +173 -0
- package/.mindforge/skills/concept-diagrams/examples/smartphone-layer-anatomy.md +154 -0
- package/.mindforge/skills/concept-diagrams/examples/sn2-reaction-mechanism.md +247 -0
- package/.mindforge/skills/concept-diagrams/examples/wind-turbine-structure.md +338 -0
- package/.mindforge/skills/concept-diagrams/references/dashboard-patterns.md +43 -0
- package/.mindforge/skills/concept-diagrams/references/infrastructure-patterns.md +144 -0
- package/.mindforge/skills/concept-diagrams/references/physical-shape-cookbook.md +42 -0
- package/.mindforge/skills/concept-diagrams/templates/template.html +174 -0
- package/.mindforge/skills/creative-ideation/references/full-prompt-library.md +110 -0
- package/.mindforge/skills/documentation/SKILL.md +1 -1
- package/.mindforge/skills/domain-intel/SKILL.md +7 -7
- package/.mindforge/skills/domain-intel/scripts/domain_intel.py +397 -0
- package/.mindforge/skills/duckduckgo-search/SKILL.md +17 -17
- package/.mindforge/skills/duckduckgo-search/scripts/duckduckgo.sh +28 -0
- package/.mindforge/skills/environment-management/SKILL.md +1 -1
- package/.mindforge/skills/github-code-review/SKILL.md +9 -9
- package/.mindforge/skills/github-code-review/references/review-output-template.md +74 -0
- package/.mindforge/skills/github-issues/templates/bug-report.md +35 -0
- package/.mindforge/skills/github-issues/templates/feature-request.md +31 -0
- package/.mindforge/skills/github-pr-workflow/SKILL.md +3 -3
- package/.mindforge/skills/github-pr-workflow/references/ci-troubleshooting.md +183 -0
- package/.mindforge/skills/github-pr-workflow/references/conventional-commits.md +71 -0
- package/.mindforge/skills/github-pr-workflow/templates/pr-body-bugfix.md +35 -0
- package/.mindforge/skills/github-pr-workflow/templates/pr-body-feature.md +33 -0
- package/.mindforge/skills/incident-response/SKILL.md +1 -1
- package/.mindforge/skills/jupyter-live-kernel/SKILL.md +3 -3
- package/.mindforge/skills/kanban-orchestrator/SKILL.md +10 -10
- package/.mindforge/skills/kanban-worker/SKILL.md +6 -6
- package/.mindforge/skills/meme-generation/SKILL.md +1 -1
- package/.mindforge/skills/meme-generation/scripts/generate_meme.py +470 -0
- package/.mindforge/skills/meme-generation/scripts/templates.json +97 -0
- package/.mindforge/skills/obsidian/SKILL.md +15 -15
- package/.mindforge/skills/orch-pipeline/SKILL.md +2 -2
- package/.mindforge/skills/osint-investigation/SKILL.md +3 -2
- package/.mindforge/skills/osint-investigation/references/sources/courtlistener.md +98 -0
- package/.mindforge/skills/osint-investigation/references/sources/gdelt.md +104 -0
- package/.mindforge/skills/osint-investigation/references/sources/icij-offshore.md +104 -0
- package/.mindforge/skills/osint-investigation/references/sources/nyc-acris.md +90 -0
- package/.mindforge/skills/osint-investigation/references/sources/ofac-sdn.md +92 -0
- package/.mindforge/skills/osint-investigation/references/sources/opencorporates.md +103 -0
- package/.mindforge/skills/osint-investigation/references/sources/sec-edgar.md +83 -0
- package/.mindforge/skills/osint-investigation/references/sources/senate-ld.md +89 -0
- package/.mindforge/skills/osint-investigation/references/sources/usaspending.md +97 -0
- package/.mindforge/skills/osint-investigation/references/sources/wayback.md +93 -0
- package/.mindforge/skills/osint-investigation/references/sources/wikipedia.md +107 -0
- package/.mindforge/skills/osint-investigation/scripts/_http.py +82 -0
- package/.mindforge/skills/osint-investigation/scripts/_normalize.py +67 -0
- package/.mindforge/skills/osint-investigation/scripts/build_findings.py +221 -0
- package/.mindforge/skills/osint-investigation/scripts/entity_resolution.py +228 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_courtlistener.py +149 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_gdelt.py +161 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_icij_offshore.py +234 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_nyc_acris.py +203 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_ofac_sdn.py +175 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_opencorporates.py +191 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_sec_edgar.py +184 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_senate_ld.py +146 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_usaspending.py +170 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_wayback.py +142 -0
- package/.mindforge/skills/osint-investigation/scripts/fetch_wikipedia.py +266 -0
- package/.mindforge/skills/osint-investigation/scripts/timing_analysis.py +252 -0
- package/.mindforge/skills/osint-investigation/templates/source-template.md +59 -0
- package/.mindforge/skills/oss-forensics/SKILL.md +6 -6
- package/.mindforge/skills/oss-forensics/references/evidence-types.md +89 -0
- package/.mindforge/skills/oss-forensics/references/github-archive-guide.md +184 -0
- package/.mindforge/skills/oss-forensics/references/investigation-templates.md +131 -0
- package/.mindforge/skills/oss-forensics/references/recovery-techniques.md +164 -0
- package/.mindforge/skills/oss-forensics/scripts/evidence-store.py +313 -0
- package/.mindforge/skills/oss-forensics/templates/forensic-report.md +151 -0
- package/.mindforge/skills/oss-forensics/templates/malicious-package-report.md +43 -0
- package/.mindforge/skills/pixel-art/SKILL.md +2 -2
- package/.mindforge/skills/pixel-art/references/palettes.md +49 -0
- package/.mindforge/skills/plan/SKILL.md +10 -10
- package/.mindforge/skills/requesting-code-review/SKILL.md +4 -6
- package/.mindforge/skills/research-paper-writing/SKILL.md +32 -32
- package/.mindforge/skills/research-paper-writing/references/autoreason-methodology.md +394 -0
- package/.mindforge/skills/research-paper-writing/references/checklists.md +434 -0
- package/.mindforge/skills/research-paper-writing/references/citation-workflow.md +563 -0
- package/.mindforge/skills/research-paper-writing/references/experiment-patterns.md +728 -0
- package/.mindforge/skills/research-paper-writing/references/human-evaluation.md +476 -0
- package/.mindforge/skills/research-paper-writing/references/paper-types.md +481 -0
- package/.mindforge/skills/research-paper-writing/references/reviewer-guidelines.md +433 -0
- package/.mindforge/skills/research-paper-writing/references/sources.md +191 -0
- package/.mindforge/skills/research-paper-writing/references/writing-guide.md +474 -0
- package/.mindforge/skills/research-paper-writing/templates/README.md +251 -0
- package/.mindforge/skills/scrapling/SKILL.md +1 -1
- package/.mindforge/skills/security-review/SKILL.md +1 -1
- package/.mindforge/skills/sherlock/SKILL.md +1 -1
- package/.mindforge/skills/simplify-code/SKILL.md +5 -7
- package/.mindforge/skills/spike/SKILL.md +11 -13
- package/.mindforge/skills/subagent-driven-development/SKILL.md +7 -11
- package/.mindforge/skills/subagent-driven-development/references/context-budget-discipline.md +53 -0
- package/.mindforge/skills/subagent-driven-development/references/gates-taxonomy.md +93 -0
- package/.mindforge/skills/systematic-debugging/SKILL.md +13 -14
- package/.mindforge/skills/test-driven-development/SKILL.md +7 -8
- package/.mindforge/skills/testing-standards/SKILL.md +1 -1
- package/.mindforge/skills/web-pentest/SKILL.md +2 -2
- package/.mindforge/skills/web-pentest/references/bypass-techniques.md +133 -0
- package/.mindforge/skills/web-pentest/references/exploitation-techniques.md +204 -0
- package/.mindforge/skills/web-pentest/references/scope-enforcement.md +110 -0
- package/.mindforge/skills/web-pentest/references/vuln-taxonomy.md +81 -0
- package/.mindforge/skills/web-pentest/templates/authorization.md +69 -0
- package/.mindforge/skills/web-pentest/templates/pentest-report.md +178 -0
- package/.mindforge/skills/writing-skills/SKILL.md +4 -3
- package/CHANGELOG.md +35 -0
- package/MINDFORGE.md +3 -3
- package/README.md +9 -7
- package/RELEASENOTES.md +65 -2
- package/SECURITY.md +5 -3
- package/bin/autonomous/auto-runner.js +5 -2
- package/bin/engine/skill-loader.js +4 -0
- package/bin/governance/rbac.js +4 -0
- package/bin/memory/eis-client.js +1 -0
- package/bin/mindforge-cli.js +5 -0
- package/bin/models/bedrock-provider.js +192 -0
- package/bin/models/model-client.js +19 -0
- package/bin/spawn-agent.js +9 -2
- package/docs/commands-reference.md +68 -6
- package/docs/faq.md +38 -1
- package/docs/getting-started.md +27 -12
- package/docs/sdk-reference.md +36 -3
- package/docs/troubleshooting.md +59 -1
- package/docs/user-guide.md +7 -4
- package/package.json +3 -3
- package/.claude/commands/mindforge/skill-tdd.md +0 -53
- package/.claude/commands/mindforge/skills-index.md +0 -118
- package/.claude/commands/mindforge/systematic-debug.md +0 -60
- package/.claude/commands/mindforge/wf-accessibility-audit.md +0 -31
- package/.claude/commands/mindforge/wf-ai-model-eval.md +0 -31
- package/.claude/commands/mindforge/wf-api-migration.md +0 -31
- package/.claude/commands/mindforge/wf-architecture-modernization.md +0 -32
- package/.claude/commands/mindforge/wf-catalog.md +0 -59
- package/.claude/commands/mindforge/wf-code-audit.md +0 -31
- package/.claude/commands/mindforge/wf-code-explainer.md +0 -31
- package/.claude/commands/mindforge/wf-competitive-analysis.md +0 -31
- package/.claude/commands/mindforge/wf-competitive-teardown.md +0 -31
- package/.claude/commands/mindforge/wf-cost-analysis.md +0 -31
- package/.claude/commands/mindforge/wf-data-pipeline-validate.md +0 -31
- package/.claude/commands/mindforge/wf-database-migration.md +0 -31
- package/.claude/commands/mindforge/wf-debug-detective.md +0 -32
- package/.claude/commands/mindforge/wf-design-system-audit.md +0 -31
- package/.claude/commands/mindforge/wf-documentation-gen.md +0 -31
- package/.claude/commands/mindforge/wf-feature-planner.md +0 -31
- package/.claude/commands/mindforge/wf-incident-response.md +0 -31
- package/.claude/commands/mindforge/wf-multi-repo-sync.md +0 -31
- package/.claude/commands/mindforge/wf-mutation-testing.md +0 -31
- package/.claude/commands/mindforge/wf-onboard-codebase.md +0 -31
- package/.claude/commands/mindforge/wf-perf-optimize.md +0 -31
- package/.claude/commands/mindforge/wf-pr-review.md +0 -31
- package/.claude/commands/mindforge/wf-refactor-plan.md +0 -31
- package/.claude/commands/mindforge/wf-release-prep.md +0 -31
- package/.claude/commands/mindforge/wf-security-threat-model.md +0 -31
- package/.claude/commands/mindforge/wf-tdd-sprint.md +0 -31
- package/.claude/commands/mindforge/wf-tech-evaluation.md +0 -31
- package/.claude/commands/mindforge/wf-ux-heuristic-audit.md +0 -31
- package/.claude/commands/mindforge/wf-writer-reviewer.md +0 -30
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
const Router = require('./model-router');
|
|
8
8
|
const CostTracker = require('./cost-tracker');
|
|
9
9
|
const AnthropicProvider = require('./anthropic-provider');
|
|
10
|
+
const BedrockProvider = require('./bedrock-provider');
|
|
10
11
|
const OpenAIProvider = require('./openai-provider');
|
|
11
12
|
const GeminiProvider = require('./gemini-provider');
|
|
12
13
|
const OllamaProvider = require('./ollama-provider');
|
|
@@ -132,6 +133,24 @@ class ModelClient {
|
|
|
132
133
|
const registered = resolveProvider(modelId);
|
|
133
134
|
if (registered) return registered;
|
|
134
135
|
|
|
136
|
+
// Bedrock: explicit opt-in via MINDFORGE_LLM_PROVIDER=bedrock OR
|
|
137
|
+
// when ANTHROPIC_API_KEY is absent but AWS credentials are present.
|
|
138
|
+
// Supports both short IDs (claude-sonnet-4-6) and native Bedrock IDs
|
|
139
|
+
// (us.anthropic.*, anthropic.claude-*).
|
|
140
|
+
const bedrockModelPrefixes = modelId.startsWith('us.anthropic.') || modelId.startsWith('anthropic.claude');
|
|
141
|
+
const useBedrockExplicit = process.env.MINDFORGE_LLM_PROVIDER === 'bedrock';
|
|
142
|
+
const awsCredsPresent = !!(process.env.AWS_ACCESS_KEY_ID || process.env.AWS_PROFILE);
|
|
143
|
+
const anthropicKeyAbsent = !process.env.ANTHROPIC_API_KEY;
|
|
144
|
+
|
|
145
|
+
if (bedrockModelPrefixes || useBedrockExplicit || (anthropicKeyAbsent && awsCredsPresent && modelId.startsWith('claude'))) {
|
|
146
|
+
return new BedrockProvider({
|
|
147
|
+
region: process.env.AWS_REGION,
|
|
148
|
+
accessKey: process.env.AWS_ACCESS_KEY_ID,
|
|
149
|
+
secretKey: process.env.AWS_SECRET_ACCESS_KEY,
|
|
150
|
+
profile: process.env.AWS_PROFILE,
|
|
151
|
+
});
|
|
152
|
+
}
|
|
153
|
+
|
|
135
154
|
if (modelId.startsWith('claude') || modelId.startsWith('anthropic.claude')) {
|
|
136
155
|
if (!process.env.ANTHROPIC_API_KEY) return null;
|
|
137
156
|
return new AnthropicProvider(process.env.ANTHROPIC_API_KEY);
|
package/bin/spawn-agent.js
CHANGED
|
@@ -25,8 +25,14 @@ const SAFE_NAME_PATTERN = /^[A-Za-z0-9-_]+$/;
|
|
|
25
25
|
|
|
26
26
|
if (!MODE || !TARGET) {
|
|
27
27
|
console.error('❌ Usage: node bin/spawn-agent.js <mode> <target> [--dry-run]');
|
|
28
|
-
console.error('
|
|
29
|
-
console.error('
|
|
28
|
+
console.error('');
|
|
29
|
+
console.error(' Modes:');
|
|
30
|
+
console.error(' identity — resolve persona identity file [NOT IMPLEMENTED in v1.0]');
|
|
31
|
+
console.error(' spawn — dispatch agent to Claude Code runtime [NOT IMPLEMENTED in v1.0]');
|
|
32
|
+
console.error(' subagent — launch a fresh-context subagent (dry-run only)');
|
|
33
|
+
console.error('');
|
|
34
|
+
console.error(' Note: spawn and identity require Claude Code slash commands in v1.0.');
|
|
35
|
+
console.error(' Use /mindforge:auto or /mindforge:next to dispatch agents.');
|
|
30
36
|
process.exit(1);
|
|
31
37
|
}
|
|
32
38
|
|
|
@@ -100,6 +106,7 @@ async function run() {
|
|
|
100
106
|
}
|
|
101
107
|
console.log(`📡 Loading specialized identity: ${TARGET}`);
|
|
102
108
|
} else if (MODE === 'spawn') {
|
|
109
|
+
assertSafeName(TARGET); // path-containment guard — mirrors subagent branch
|
|
103
110
|
personaPath = path.join(ROOT, '.mindforge', 'personas', `${TARGET}.md`);
|
|
104
111
|
if (!fs.existsSync(personaPath)) {
|
|
105
112
|
console.error(`❌ Persona not found: ${personaPath}`);
|
|
@@ -142,7 +142,7 @@ High-fidelity behaviors ported from the Superpowers library and hardened for pro
|
|
|
142
142
|
|
|
143
143
|
---
|
|
144
144
|
|
|
145
|
-
## 11. Council, Verification & Intelligence (
|
|
145
|
+
## 11. Council, Verification & Intelligence (v11.9.0)
|
|
146
146
|
|
|
147
147
|
New commands introduced in the "Council Awakens" release for multi-voice decision-making, verification rigor, and self-evolving agent behavior.
|
|
148
148
|
|
|
@@ -183,8 +183,8 @@ mindforge <command> [options]
|
|
|
183
183
|
| `remember` | Manage the long-term memory (knowledge graph) |
|
|
184
184
|
| `learn-skill` | Ingest source and generate a validated SKILL.md |
|
|
185
185
|
| `marketplace` | Search and install community skills |
|
|
186
|
-
| `spawn` | Spawn a persona essence (e.g., mf-planner) |
|
|
187
|
-
| `identity` | Invoke a specialized identity from /agents/ |
|
|
186
|
+
| `spawn` | Spawn a persona essence (e.g., mf-planner) [v1.0: stub — dispatch not yet implemented] |
|
|
187
|
+
| `identity` | Invoke a specialized identity from /agents/ [v1.0: stub — dispatch not yet implemented] |
|
|
188
188
|
| `temporal` | Manage time-travel debugging and state history |
|
|
189
189
|
| `hindsight` | Inject a fix into a past point and regenerate state |
|
|
190
190
|
| `harvest` | Proactively harvest semantic intent from the intelligence mesh |
|
|
@@ -202,13 +202,12 @@ mindforge <command> [options]
|
|
|
202
202
|
|
|
203
203
|
## 🚀 Dynamic Workflow Library
|
|
204
204
|
|
|
205
|
-
Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands. Each runs via Claude Code's `Workflow` tool with true parallel agent execution.
|
|
205
|
+
Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands. Each runs via Claude Code's `Workflow` tool with true parallel agent execution. **32 pre-built multi-agent workflows** across 5 tiers.
|
|
206
206
|
|
|
207
207
|
| Command | Tier | Description |
|
|
208
208
|
| :--- | :--- | :--- |
|
|
209
|
-
| `/mindforge:wf-catalog` | — | Browse all
|
|
209
|
+
| `/mindforge:wf-catalog` | — | Browse all 32 workflows grouped by tier |
|
|
210
210
|
| **Research tier** | | |
|
|
211
|
-
| `/mindforge:wf-deep-research` | research | Fan-out web research with adversarial claim verification and cited synthesis |
|
|
212
211
|
| `/mindforge:wf-competitive-analysis` | research | Multi-angle competitive research producing a SWOT and positioning summary |
|
|
213
212
|
| `/mindforge:wf-tech-evaluation` | research | Scored technology evaluation across DX, performance, security, ecosystem, and community |
|
|
214
213
|
| `/mindforge:wf-ai-model-eval` | research | 4-parallel model benchmark agents → scoring matrix → cost/performance recommendation |
|
|
@@ -246,3 +245,66 @@ Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands.
|
|
|
246
245
|
| `/mindforge:wf-accessibility-audit` | beast | WCAG 2.2 parallel per-criterion audit → 3-vote adversarial verify failures → remediation spec |
|
|
247
246
|
| `/mindforge:wf-security-threat-model` | beast | Asset inventory → STRIDE threat enumeration → parallel mitigations → CVSS-style score matrix |
|
|
248
247
|
|
|
248
|
+
---
|
|
249
|
+
|
|
250
|
+
## Dynamic Workflow Library (32 workflows)
|
|
251
|
+
|
|
252
|
+
All workflow commands follow the pattern `/mindforge:wf-<name>`.
|
|
253
|
+
|
|
254
|
+
Invoke via CLI:
|
|
255
|
+
```bash
|
|
256
|
+
node bin/mindforge-cli.js workflow list # browse all 32
|
|
257
|
+
node bin/mindforge-cli.js workflow info <name> # phases + description
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
### Research Tier (5 workflows)
|
|
261
|
+
| Command | Description |
|
|
262
|
+
|---------|-------------|
|
|
263
|
+
| `/mindforge:wf-competitive-analysis` | SWOT and positioning from 5 parallel research angles |
|
|
264
|
+
| `/mindforge:wf-tech-evaluation` | Scored technology evaluation across 5 dimensions |
|
|
265
|
+
| `/mindforge:wf-ai-model-eval` | Benchmark AI models → scoring matrix → recommendation |
|
|
266
|
+
| `/mindforge:wf-ux-heuristic-audit` | 10 Nielsen heuristics parallel audit → fix brief |
|
|
267
|
+
| `/mindforge:wf-competitive-teardown` | 5 competitor angles → positioning report |
|
|
268
|
+
|
|
269
|
+
### Dev Tier (12 workflows)
|
|
270
|
+
| Command | Description |
|
|
271
|
+
|---------|-------------|
|
|
272
|
+
| `/mindforge:wf-code-audit` | Parallel security + quality + performance audit |
|
|
273
|
+
| `/mindforge:wf-feature-planner` | Brief → PRD → architecture → user stories |
|
|
274
|
+
| `/mindforge:wf-pr-review` | 4-dimensional parallel PR review → verdict |
|
|
275
|
+
| `/mindforge:wf-tdd-sprint` | Strict Red-Green-Refactor TDD loop |
|
|
276
|
+
| `/mindforge:wf-refactor-plan` | Technical debt scan → risk-sorted refactor plan |
|
|
277
|
+
| `/mindforge:wf-test-coverage-gap` | Per-module coverage analysis → test-writing plan |
|
|
278
|
+
| `/mindforge:wf-api-contract-test` | Spec vs impl Writer/Reviewer → violation report |
|
|
279
|
+
| `/mindforge:wf-debug-detective` | 4-hypothesis parallel investigation → scientific RCA |
|
|
280
|
+
| `/mindforge:wf-writer-reviewer` | Implement → fresh context review → verdict |
|
|
281
|
+
| `/mindforge:wf-mutation-testing` | Mutant generator → parallel kill-test → score |
|
|
282
|
+
| `/mindforge:wf-code-explainer` | Structure → domain → architecture → narrative tour |
|
|
283
|
+
| `/mindforge:wf-design-system-audit` | 5-dimension parallel audit → consistency score |
|
|
284
|
+
|
|
285
|
+
### Ops Tier (6 workflows)
|
|
286
|
+
| Command | Description |
|
|
287
|
+
|---------|-------------|
|
|
288
|
+
| `/mindforge:wf-incident-response` | Parallel investigation → RCA → postmortem |
|
|
289
|
+
| `/mindforge:wf-release-prep` | Tests → changelog → version bump → PR |
|
|
290
|
+
| `/mindforge:wf-dependency-health` | CVE + license + staleness audit → risk matrix |
|
|
291
|
+
| `/mindforge:wf-database-migration` | Schema diff → risk → scripts → runbook |
|
|
292
|
+
| `/mindforge:wf-multi-repo-sync` | Per-repo audit → divergence map → sync plan |
|
|
293
|
+
| `/mindforge:wf-cost-analysis` | Infra/API/query/bundle cost agents → ROI plan |
|
|
294
|
+
|
|
295
|
+
### Intelligence Tier (6 workflows)
|
|
296
|
+
| Command | Description |
|
|
297
|
+
|---------|-------------|
|
|
298
|
+
| `/mindforge:wf-onboard-codebase` | Map → domain → architecture → guided tour |
|
|
299
|
+
| `/mindforge:wf-perf-optimize` | Profile → bottleneck hunt → prioritized fix plan |
|
|
300
|
+
| `/mindforge:wf-architecture-modernization` | Legacy map → 3 designs → migration roadmap |
|
|
301
|
+
| `/mindforge:wf-documentation-gen` | Parallel doc gen → normalize → publish-ready |
|
|
302
|
+
| `/mindforge:wf-api-migration` | Breaking change detection → guide → compat matrix |
|
|
303
|
+
| `/mindforge:wf-data-pipeline-validate` | Stage-by-stage validation → quality gates |
|
|
304
|
+
|
|
305
|
+
### Beast Tier (3 workflows — 5 phases, 8+ agents, adversarial 3-vote verification)
|
|
306
|
+
| Command | Description |
|
|
307
|
+
|---------|-------------|
|
|
308
|
+
| `/mindforge:wf-security-hardening` | 5-angle OWASP scout → 3-vote verify → STRIDE → roadmap |
|
|
309
|
+
| `/mindforge:wf-accessibility-audit` | WCAG 2.2 per-criterion → 3-vote verify → remediation spec |
|
|
310
|
+
| `/mindforge:wf-security-threat-model` | Asset inventory → STRIDE x6 → mitigations → CVSS matrix |
|
package/docs/faq.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# MindForge FAQ (
|
|
1
|
+
# MindForge FAQ (v11.9.0)
|
|
2
2
|
|
|
3
3
|
## Is MindForge tied to Claude only?
|
|
4
4
|
No. MindForge supports Claude Code and Antigravity. Install with `--claude`,
|
|
@@ -36,3 +36,40 @@ Plugins are preferred for sharing and versioning.
|
|
|
36
36
|
/mindforge:update
|
|
37
37
|
/mindforge:update --apply
|
|
38
38
|
```
|
|
39
|
+
|
|
40
|
+
## Dynamic Workflows
|
|
41
|
+
|
|
42
|
+
**Q: How many workflows does MindForge v11.9.0 include?**
|
|
43
|
+
32 pre-built multi-agent workflows across 5 tiers: Research (5), Dev (12), Ops (6), Intelligence (6), Beast (3).
|
|
44
|
+
|
|
45
|
+
**Q: How do I run a workflow?**
|
|
46
|
+
Via Claude Code slash command: `/mindforge:wf-code-audit`
|
|
47
|
+
Via CLI: `node bin/mindforge-cli.js workflow list` to browse, then `workflow info <name>` for details.
|
|
48
|
+
|
|
49
|
+
**Q: What is the Beast tier?**
|
|
50
|
+
Beast tier workflows run 5 phases with 8+ concurrent agents and adversarial 3-vote verification. Included: `security-hardening`, `accessibility-audit`, `security-threat-model`.
|
|
51
|
+
|
|
52
|
+
**Q: Why are there only 32 workflows when some docs say 33?**
|
|
53
|
+
The `deep-research` workflow was removed before the v11.8.0 release (the superpowers built-in `/deep-research` covers this better). The correct count is 32.
|
|
54
|
+
|
|
55
|
+
## Version & Stability
|
|
56
|
+
|
|
57
|
+
**Q: What version is current?**
|
|
58
|
+
v11.9.0 — verify with `node bin/mindforge-cli.js --version`
|
|
59
|
+
|
|
60
|
+
**Q: Is v11.9.0 production-stable?**
|
|
61
|
+
Yes. The IQ200 deep-audit (258 discrete checks across 14 dimensions) shows 258/258 passing. 0 CVEs, 0 test failures, 0 ESLint errors, 0 TypeScript errors.
|
|
62
|
+
|
|
63
|
+
**Q: What npm dist-tags point to v11.9.0?**
|
|
64
|
+
Both `latest` and `stable`: `npx mindforge-cc@stable` or `npx mindforge-cc@latest`
|
|
65
|
+
|
|
66
|
+
## Known Limitations
|
|
67
|
+
|
|
68
|
+
**Q: Why does `spawn architect` exit with an error?**
|
|
69
|
+
Spawn dispatch is not yet implemented in v11.9.0. Use `/mindforge:auto` or `/mindforge:next` from Claude Code instead.
|
|
70
|
+
|
|
71
|
+
**Q: Why does ZTAI show a Tier-3 warning?**
|
|
72
|
+
Tier-3 trust uses in-process key simulation in v11.9.0 — this is intentional and safe. `SECURITY_TIER_3_SIMULATED = true` is the documented v11.x behavior. Hardware TPM/HSM is planned for v12.x.
|
|
73
|
+
|
|
74
|
+
**Q: What is the test coverage?**
|
|
75
|
+
95/97 tests passing (0 failures, 2 permanently env-skipped). Line coverage ~66% — gaps are in `bin/source-loader.js` and `scripts/ci/validate-assets.js`. Target is 80% for v11.9.0.
|
package/docs/getting-started.md
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
|
-
# MindForge — Getting Started (v11.
|
|
1
|
+
# MindForge — Getting Started (v11.9.0)
|
|
2
2
|
|
|
3
3
|
This guide gets you from zero to a working MindForge project in under five minutes.
|
|
4
4
|
|
|
5
5
|
## Prerequisites
|
|
6
6
|
|
|
7
|
-
- **Node.js 18
|
|
8
|
-
-
|
|
7
|
+
- **Node.js** >= 18.0.0 (`node --version` to check)
|
|
8
|
+
- **Claude Code** CLI installed and authenticated (`claude --version`)
|
|
9
|
+
- Git (recommended for project-level install)
|
|
9
10
|
|
|
10
11
|
## Install
|
|
11
12
|
|
|
@@ -45,7 +46,7 @@ Run the MindForge MCP server (`mindforge-mcp-server`) over stdio — it exposes
|
|
|
45
46
|
claude mcp add mindforge -- npx -y mindforge-mcp-server
|
|
46
47
|
```
|
|
47
48
|
|
|
48
|
-
This server is also published to the [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.sairam0424/mindforge` (currently `11.
|
|
49
|
+
This server is also published to the [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.sairam0424/mindforge` (currently `11.9.0`, marked latest).
|
|
49
50
|
|
|
50
51
|
### 4. Homebrew
|
|
51
52
|
|
|
@@ -61,17 +62,31 @@ To build on top of MindForge programmatically, install the TypeScript SDK:
|
|
|
61
62
|
npm i mindforge-sdk
|
|
62
63
|
```
|
|
63
64
|
|
|
64
|
-
## Dynamic Workflow Library
|
|
65
|
+
## Dynamic Workflow Library (32 workflows across 5 tiers)
|
|
65
66
|
|
|
66
|
-
MindForge ships 33 pre-built multi-agent workflows across 5 tiers, triggerable via `/mindforge:wf-*` commands:
|
|
67
67
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
68
|
+
| Tier | Count | Workflows |
|
|
69
|
+
|------|-------|-----------|
|
|
70
|
+
| Research | 5 | competitive-analysis, tech-evaluation, ai-model-eval, ux-heuristic-audit, competitive-teardown |
|
|
71
|
+
| Dev | 12 | code-audit, feature-planner, pr-review, tdd-sprint, refactor-plan, test-coverage-gap, api-contract-test, debug-detective, writer-reviewer, mutation-testing, code-explainer, design-system-audit |
|
|
72
|
+
| Ops | 6 | incident-response, release-prep, dependency-health, database-migration, multi-repo-sync, cost-analysis |
|
|
73
|
+
| Intelligence | 6 | onboard-codebase, perf-optimize, architecture-modernization, documentation-gen, api-migration, data-pipeline-validate |
|
|
74
|
+
| Beast | 3 | security-hardening, accessibility-audit, security-threat-model |
|
|
73
75
|
|
|
74
|
-
|
|
76
|
+
**Run any workflow:**
|
|
77
|
+
```bash
|
|
78
|
+
node bin/mindforge-cli.js workflow list # browse all 32
|
|
79
|
+
node bin/mindforge-cli.js workflow info code-audit # details + phases
|
|
80
|
+
```
|
|
81
|
+
Or use slash commands: `/mindforge:wf-code-audit`
|
|
82
|
+
|
|
83
|
+
## Your First 5 Minutes with MindForge
|
|
84
|
+
|
|
85
|
+
1. **Verify install:** `node bin/mindforge-cli.js health`
|
|
86
|
+
2. **Check version:** `node bin/mindforge-cli.js --version` (should print `11.9.0`)
|
|
87
|
+
3. **List workflows:** `node bin/mindforge-cli.js workflow list`
|
|
88
|
+
4. **Run first slash command:** Open Claude Code → `/mindforge:status`
|
|
89
|
+
5. **Onboard your codebase:** Open Claude Code → `/mindforge:wf-onboard-codebase`
|
|
75
90
|
|
|
76
91
|
## Initialise Your Project
|
|
77
92
|
|
package/docs/sdk-reference.md
CHANGED
|
@@ -14,7 +14,24 @@ import {
|
|
|
14
14
|
} from '@mindforge/sdk';
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
Current SDK version: `11.
|
|
17
|
+
Current SDK version: `11.9.0`
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## SDK Exports (v11.9.0)
|
|
22
|
+
|
|
23
|
+
```javascript
|
|
24
|
+
const {
|
|
25
|
+
MindForgeClient, // Main API client
|
|
26
|
+
MindForgeEventStream, // SSE event stream
|
|
27
|
+
WebSocketEventStream, // WebSocket stream
|
|
28
|
+
commands, // Command registry
|
|
29
|
+
batch, // Batch execution
|
|
30
|
+
MindForgeMemory, // Memory interface
|
|
31
|
+
VERSION // '11.9.0'
|
|
32
|
+
} = require('mindforge-sdk');
|
|
33
|
+
// or: import { MindForgeClient, VERSION } from 'mindforge-sdk';
|
|
34
|
+
```
|
|
18
35
|
|
|
19
36
|
---
|
|
20
37
|
|
|
@@ -97,13 +114,13 @@ Returns the absolute path to the project's `celestial.db` SQLite database file.
|
|
|
97
114
|
|
|
98
115
|
Imports a session snapshot captured from a browser environment into the local session store.
|
|
99
116
|
|
|
100
|
-
> **[NOT IMPLEMENTED —
|
|
117
|
+
> **[NOT IMPLEMENTED — v11.x]** This method always throws. Planned for a future release. Use `saveSession`/`loadSession` instead. Check `capabilities.importFromBrowser === false` before calling.
|
|
101
118
|
|
|
102
119
|
#### `resolveRemoteNode(nodeId: string): Promise<unknown>`
|
|
103
120
|
|
|
104
121
|
Resolves context for a node residing on a remote EIS (Edge Intelligence Shard) instance.
|
|
105
122
|
|
|
106
|
-
> **[NOT IMPLEMENTED —
|
|
123
|
+
> **[NOT IMPLEMENTED — v11.x]** This method always throws. Planned for a future release. Cross-node context resolution is local-only in v11.x. Planned for v12.x.
|
|
107
124
|
|
|
108
125
|
---
|
|
109
126
|
|
|
@@ -387,3 +404,19 @@ count, deprecation state, and SHA-256 checksum.
|
|
|
387
404
|
- CORS is restricted to localhost origins (exact match, no wildcards).
|
|
388
405
|
- Do not expose SDK endpoints or the SSE server to public networks.
|
|
389
406
|
- API keys passed via `MindForgeConfig` are held in memory only — never written to disk.
|
|
407
|
+
|
|
408
|
+
---
|
|
409
|
+
|
|
410
|
+
## TypeScript
|
|
411
|
+
|
|
412
|
+
The SDK includes full TypeScript type definitions. Build the SDK:
|
|
413
|
+
```bash
|
|
414
|
+
cd sdk && npm install && npm run build
|
|
415
|
+
```
|
|
416
|
+
`@types/node` is installed as a dev dependency. The SDK achieves **0 typecheck errors** in v11.9.0.
|
|
417
|
+
|
|
418
|
+
## Installation
|
|
419
|
+
```bash
|
|
420
|
+
npm install mindforge-sdk@11.9.0
|
|
421
|
+
# or: npx mindforge-cc@stable # installs SDK as part of the framework
|
|
422
|
+
```
|
package/docs/troubleshooting.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# MindForge Troubleshooting (v11.
|
|
1
|
+
# MindForge Troubleshooting (v11.9.0)
|
|
2
2
|
|
|
3
3
|
This page lists common issues and fast fixes. If you get stuck, start with
|
|
4
4
|
`/mindforge:health`.
|
|
@@ -146,3 +146,61 @@ Browser cookie import from native browser profiles is not implemented in v1.0. U
|
|
|
146
146
|
|
|
147
147
|
## Tests fail when run from a parent directory
|
|
148
148
|
All tests must be run from the MindForge project root: `cd /path/to/MindForge && npm test`. Running from the parent workspace will produce false failures.
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## Agent spawn returns immediately with no action
|
|
153
|
+
|
|
154
|
+
**Symptom:** `node bin/spawn-agent.js spawn architect` exits 1 with "Agent spawn dispatch not implemented in v1.0."
|
|
155
|
+
|
|
156
|
+
**Cause:** Spawn dispatch is a v1.0 stub — real agent dispatch requires Claude Code slash commands.
|
|
157
|
+
|
|
158
|
+
**Fix:** Use `/mindforge:auto` or `/mindforge:next` from Claude Code instead.
|
|
159
|
+
|
|
160
|
+
---
|
|
161
|
+
|
|
162
|
+
## `importFromBrowser` crashes with "not implemented"
|
|
163
|
+
|
|
164
|
+
**Symptom:** Calling `importFromBrowser(source)` throws unconditionally.
|
|
165
|
+
|
|
166
|
+
**Cause:** Native browser cookie DB import was removed when `better-sqlite3` was replaced with sql.js/WASM.
|
|
167
|
+
|
|
168
|
+
**Fix:** Use `saveSession`/`loadSession` instead. Check `sessionManager.capabilities.importFromBrowser` (returns `false`) before calling.
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## Tests fail when run from parent directory
|
|
173
|
+
|
|
174
|
+
**Symptom:** ~52 false test failures when running `npm test` from `Not-Humans-World/` parent.
|
|
175
|
+
|
|
176
|
+
**Cause:** Test files use relative paths anchored to the MindForge project root.
|
|
177
|
+
|
|
178
|
+
**Fix:** Always run from the MindForge root: `cd /path/to/MindForge && npm test`
|
|
179
|
+
|
|
180
|
+
---
|
|
181
|
+
|
|
182
|
+
## `node bin/mindforge-cli.js validate-config` prints "Unknown command"
|
|
183
|
+
|
|
184
|
+
**Symptom:** The CLI does not recognize `validate-config` as a subcommand.
|
|
185
|
+
|
|
186
|
+
**Cause:** `validate-config` is exposed as a standalone binary, not a CLI subcommand.
|
|
187
|
+
|
|
188
|
+
**Fix:** Run `node bin/validate-config.js` directly.
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
## ZTAI Tier-3 warning appears unexpectedly
|
|
193
|
+
|
|
194
|
+
**Symptom:** `[ZTAI] WARNING: Tier-3 trust using simulated in-process key storage` appears on commands like `pr-review`.
|
|
195
|
+
|
|
196
|
+
**Cause:** Tier-3 trust uses in-process key simulation in v11.9.0. This is expected and safe — `SECURITY_TIER_3_SIMULATED = true` is the documented behavior.
|
|
197
|
+
|
|
198
|
+
**Fix:** No action required. See `SECURITY.md` for full disclosure. This is not a security vulnerability.
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
## `node bin/mindforge-cli.js --version` exits 1 (older installs)
|
|
203
|
+
|
|
204
|
+
**Symptom:** `--version` flag reports "Unknown command" on installs older than v11.9.0.
|
|
205
|
+
|
|
206
|
+
**Fix:** Upgrade to v11.9.0: `npx mindforge-cc@latest install`
|
package/docs/user-guide.md
CHANGED
|
@@ -1,7 +1,9 @@
|
|
|
1
|
-
# MindForge User Guide (v11.
|
|
1
|
+
# MindForge User Guide (v11.9.0)
|
|
2
2
|
|
|
3
3
|
This guide gets you from install to productive, with the minimum needed to run MindForge in a real project.
|
|
4
4
|
|
|
5
|
+
> **v11.9.0 Stats:** 32 workflows · 221 slash commands · 232 engine skills · 211 personas · 0 CVEs · 258/258 IQ200 checks passing
|
|
6
|
+
|
|
5
7
|
## Prerequisites
|
|
6
8
|
|
|
7
9
|
- **Node.js 18+** (LTS recommended)
|
|
@@ -42,9 +44,10 @@ mindforge health # Verify project integrity
|
|
|
42
44
|
mindforge security-scan # Run security checks
|
|
43
45
|
mindforge headless # Run agent in non-interactive mode
|
|
44
46
|
mindforge --verbose ... # Enable verbose output for debugging
|
|
47
|
+
mindforge --version # Print installed version (e.g. 11.9.0) and exit 0
|
|
45
48
|
```
|
|
46
49
|
|
|
47
|
-
Use `--verbose` (or `-v`) on any command for detailed diagnostic output.
|
|
50
|
+
Use `--verbose` (or `-v`) on any command for detailed diagnostic output. Use `--version` (or `-V`) to print the installed version and exit.
|
|
48
51
|
|
|
49
52
|
---
|
|
50
53
|
|
|
@@ -93,7 +96,7 @@ MindForge uses a unified 4-pillar workflow, hardened by the **Neural Protocol Me
|
|
|
93
96
|
|
|
94
97
|
### Dynamic Workflow Library
|
|
95
98
|
|
|
96
|
-
MindForge ships **
|
|
99
|
+
MindForge ships **32 pre-built workflow pipelines** across **219 commands**, organized into **5 tiers**:
|
|
97
100
|
|
|
98
101
|
| Tier | Description |
|
|
99
102
|
|------|-------------|
|
|
@@ -114,7 +117,7 @@ Discover all available workflows:
|
|
|
114
117
|
|
|
115
118
|
## 6. High-Performance Personas
|
|
116
119
|
|
|
117
|
-
MindForge features
|
|
120
|
+
MindForge features 211 specialized personas. Each persona is optimized for a specific stage of the lifecycle.
|
|
118
121
|
|
|
119
122
|
- **Neural Orchestrator**: Activates and manages the advanced protocol layer.
|
|
120
123
|
- **Brainstormer**: Expert in deep requirements discovery and behavioral ideation.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mindforge-cc",
|
|
3
|
-
"version": "11.
|
|
3
|
+
"version": "11.9.0",
|
|
4
4
|
"description": "MindForge \u2014 Sovereign Agentic Intelligence Framework. Sovereign Stability: Production-Hardened Agentic Intelligence (v11)",
|
|
5
5
|
"bin": {
|
|
6
6
|
"mindforge-cc": "bin/install.js",
|
|
@@ -90,11 +90,11 @@
|
|
|
90
90
|
"homepage": "https://github.com/sairam0424/MindForge#readme",
|
|
91
91
|
"devDependencies": {
|
|
92
92
|
"@eslint/js": "^9.0.0",
|
|
93
|
-
"@types/node": "^
|
|
93
|
+
"@types/node": "^26.0.0",
|
|
94
94
|
"c8": "^10.0.0",
|
|
95
95
|
"commitizen": "^4.2.4",
|
|
96
96
|
"cz-conventional-changelog": "3.3.0",
|
|
97
|
-
"eslint": "^
|
|
97
|
+
"eslint": "^10.5.0",
|
|
98
98
|
"globals": "^15.0.0",
|
|
99
99
|
"husky": "9.1.7",
|
|
100
100
|
"playwright": "^1.40.0"
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: "Test-Driven Development — RED-GREEN-REFACTOR discipline. Write the failing test first, always."
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# MindForge — TDD Skill Command
|
|
6
|
-
# Usage: /mindforge:skill-tdd [feature or bug to implement]
|
|
7
|
-
|
|
8
|
-
Activates the test-driven development skill. The core rule: **if you didn't watch the test fail, you don't know if it tests the right thing.**
|
|
9
|
-
|
|
10
|
-
## Activation
|
|
11
|
-
|
|
12
|
-
Load `.mindforge/skills/test-driven-development/SKILL.md` immediately.
|
|
13
|
-
Follow its RED-GREEN-REFACTOR cycle strictly for the full duration of this session.
|
|
14
|
-
|
|
15
|
-
## The Cycle (non-negotiable)
|
|
16
|
-
|
|
17
|
-
### RED — Write a failing test
|
|
18
|
-
1. Identify the smallest next behavior to implement.
|
|
19
|
-
2. Write one test that asserts that behavior.
|
|
20
|
-
3. Run it — confirm it FAILS for the right reason (not a syntax error, not a missing import — the actual assertion fails).
|
|
21
|
-
4. Do not proceed until the test fails correctly.
|
|
22
|
-
|
|
23
|
-
### GREEN — Write minimal code to pass
|
|
24
|
-
1. Write the simplest code that makes the test pass.
|
|
25
|
-
2. No gold-plating, no extra features. Minimum viable.
|
|
26
|
-
3. Run the test — it must pass.
|
|
27
|
-
4. Run the full suite — no regressions.
|
|
28
|
-
|
|
29
|
-
### REFACTOR — Clean up
|
|
30
|
-
1. Improve code structure, naming, and clarity.
|
|
31
|
-
2. Remove duplication.
|
|
32
|
-
3. Tests stay green throughout — run after every change.
|
|
33
|
-
|
|
34
|
-
## Mandatory gates
|
|
35
|
-
|
|
36
|
-
- **Never write code without a failing test.** Not for "obvious" cases, not for "quick" fixes, not for "trivial" implementations.
|
|
37
|
-
- **One cycle at a time.** Complete RED-GREEN-REFACTOR before starting the next behavior.
|
|
38
|
-
- **A passing test suite is always the starting state.** If tests are red when you begin, fix them first.
|
|
39
|
-
|
|
40
|
-
## When the user asks for a feature
|
|
41
|
-
|
|
42
|
-
1. Decompose into the smallest testable behavior.
|
|
43
|
-
2. Start with the first RED step before writing any implementation.
|
|
44
|
-
3. Repeat the cycle for each behavior.
|
|
45
|
-
|
|
46
|
-
## When the user asks for a bug fix
|
|
47
|
-
|
|
48
|
-
1. Write a failing test that reproduces the bug (this is your RED step).
|
|
49
|
-
2. Confirm it fails.
|
|
50
|
-
3. Fix the code (GREEN).
|
|
51
|
-
4. Refactor if needed.
|
|
52
|
-
|
|
53
|
-
The bug test becomes the regression guard — it must remain in the suite permanently.
|
|
@@ -1,118 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: "Browse all available skills by category — discover and activate any skill by name."
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# MindForge — Skills Index
|
|
6
|
-
# Usage: /mindforge:skills-index [optional: category or keyword filter]
|
|
7
|
-
|
|
8
|
-
Lists all skills available in this MindForge installation. Skills in the **Engine** tier activate automatically via trigger-matching. Skills in the **Extended** tier require explicit invocation.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## How to activate a skill
|
|
13
|
-
|
|
14
|
-
**Engine tier** (auto-triggers from `.mindforge/skills/`): Just describe the task — the skill-loader matches your request against each skill's `triggers:` field and loads the relevant skill automatically.
|
|
15
|
-
|
|
16
|
-
**Extended tier** (explicit from `.agent/skills/`): Ask Claude to "use the [skill-name] skill" or invoke it by name.
|
|
17
|
-
|
|
18
|
-
---
|
|
19
|
-
|
|
20
|
-
## Engine Tier Skills (auto-triggered)
|
|
21
|
-
|
|
22
|
-
### Software Development
|
|
23
|
-
| Skill | Triggers |
|
|
24
|
-
|---|---|
|
|
25
|
-
| `systematic-debugging` | systematic debugging, root cause analysis, debug methodology, 4-phase debug |
|
|
26
|
-
| `test-driven-development` | TDD, red green refactor, write test first, test before code |
|
|
27
|
-
| `plan` | write a plan, plan mode, implementation plan, plan before coding |
|
|
28
|
-
| `simplify-code` | simplify code, clean up code, refactor for clarity, reduce complexity |
|
|
29
|
-
| `requesting-code-review` | request code review, code review protocol, review this PR |
|
|
30
|
-
| `spike` | technical spike, time-boxed spike, explore this problem |
|
|
31
|
-
| `subagent-driven-development` | subagent driven development, delegate to subagent, multi-agent implementation |
|
|
32
|
-
| `code-wiki` | code wiki, document codebase, knowledge wiki, explain codebase |
|
|
33
|
-
|
|
34
|
-
### DevOps & Orchestration
|
|
35
|
-
| Skill | Triggers |
|
|
36
|
-
|---|---|
|
|
37
|
-
| `kanban-orchestrator` | kanban orchestrator, multi-agent kanban, decompose and route, orchestrate tasks |
|
|
38
|
-
| `kanban-worker` | kanban worker, pick up kanban task, complete kanban card |
|
|
39
|
-
|
|
40
|
-
### GitHub Workflows
|
|
41
|
-
| Skill | Triggers |
|
|
42
|
-
|---|---|
|
|
43
|
-
| `github-code-review` | github code review, review PR, pull request review workflow |
|
|
44
|
-
| `github-pr-workflow` | github pr workflow, pull request lifecycle, open PR, merge PR |
|
|
45
|
-
| `github-issues` | github issues, create issue, manage issues, issue triage |
|
|
46
|
-
| `codebase-inspection` | codebase inspection, explore codebase, understand repository |
|
|
47
|
-
|
|
48
|
-
### Research & Intelligence
|
|
49
|
-
| Skill | Triggers |
|
|
50
|
-
|---|---|
|
|
51
|
-
| `research-paper-writing` | research paper, academic paper, write paper, arxiv paper |
|
|
52
|
-
| `arxiv` | arxiv search, find papers, search arxiv, academic literature |
|
|
53
|
-
| `osint-investigation` | OSINT investigation, public records research, entity investigation |
|
|
54
|
-
| `domain-intel` | domain intelligence, investigate domain, domain research |
|
|
55
|
-
| `duckduckgo-search` | duckduckgo search, DDG search, web search |
|
|
56
|
-
| `scrapling` | scrape website, web scraping, extract web content |
|
|
57
|
-
| `blogwatcher` | monitor blog, watch blog, track blog updates |
|
|
58
|
-
|
|
59
|
-
### Creative
|
|
60
|
-
| Skill | Triggers |
|
|
61
|
-
|---|---|
|
|
62
|
-
| `concept-diagrams` | concept diagram, educational diagram, SVG diagram, visual explanation |
|
|
63
|
-
| `creative-ideation` | creative ideation, brainstorm ideas, creative ideas, generate concepts |
|
|
64
|
-
| `pixel-art` | pixel art, create pixel art, sprite design |
|
|
65
|
-
| `meme-generation` | meme generation, create meme, generate meme |
|
|
66
|
-
|
|
67
|
-
### Security
|
|
68
|
-
| Skill | Triggers |
|
|
69
|
-
|---|---|
|
|
70
|
-
| `web-pentest` | web penetration test, pentest this app, security test web app, OWASP test |
|
|
71
|
-
| `oss-forensics` | OSS forensics, open source forensics, supply chain audit |
|
|
72
|
-
| `sherlock` | sherlock, username investigation, find accounts, OSINT username |
|
|
73
|
-
|
|
74
|
-
### Data & Tooling
|
|
75
|
-
| Skill | Triggers |
|
|
76
|
-
|---|---|
|
|
77
|
-
| `jupyter-live-kernel` | jupyter kernel, live jupyter, interactive notebook |
|
|
78
|
-
| `obsidian` | obsidian notes, obsidian vault, obsidian workflow |
|
|
79
|
-
|
|
80
|
-
---
|
|
81
|
-
|
|
82
|
-
## Extended Tier Skills (`.agent/skills/`, explicit activation)
|
|
83
|
-
|
|
84
|
-
### Software Development
|
|
85
|
-
`node-inspect-debugger` · `python-debugpy` · `skill-authoring` · `rest-graphql-debug`
|
|
86
|
-
|
|
87
|
-
### GitHub
|
|
88
|
-
`github-auth` · `github-repo-management`
|
|
89
|
-
|
|
90
|
-
### DevOps
|
|
91
|
-
`docker-management` · `devops-cli` · `devops-watchers` · `pinggy-tunnel` · `s6-container-supervision`
|
|
92
|
-
|
|
93
|
-
### Research
|
|
94
|
-
`llm-wiki` · `polymarket` · `parallel-cli`
|
|
95
|
-
|
|
96
|
-
### Security
|
|
97
|
-
`godmode` · `1password-skill`
|
|
98
|
-
|
|
99
|
-
### Creative
|
|
100
|
-
`hyperframes` · `article-illustrator` · `comic-creator` · `video-orchestrator`
|
|
101
|
-
|
|
102
|
-
---
|
|
103
|
-
|
|
104
|
-
## Usage examples
|
|
105
|
-
|
|
106
|
-
```
|
|
107
|
-
"Debug this null pointer — use systematic debugging"
|
|
108
|
-
→ Engine tier: systematic-debugging activates automatically
|
|
109
|
-
|
|
110
|
-
"I want to do TDD on this new auth module"
|
|
111
|
-
→ Engine tier: test-driven-development activates automatically
|
|
112
|
-
|
|
113
|
-
"Use the docker-management skill to set up my containers"
|
|
114
|
-
→ Extended tier: explicit invocation of docker-management
|
|
115
|
-
|
|
116
|
-
"Run an OSINT investigation on this company"
|
|
117
|
-
→ Engine tier: osint-investigation activates automatically
|
|
118
|
-
```
|