mindforge-cc 8.1.0 → 8.2.0

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/publishing-guide.md

@@ -0,0 +1,43 @@
+# MindForge Publishing Guide
+
+This guide outlines the standard procedure for publishing a new version of `mindforge-cc` and its associated SDK to npm. Following this process ensures stability, correct versioning, and structural integrity.
+
+## Prerequisites
+
+1. **NPM Permissions**: You must have publish access to the `mindforge-cc` and `@mindforge/sdk` packages.
+2. **Clean State**: Ensure all changes are committed and your working directory is clean.
+3. **Authentication**: Run `npm whoami` to verify you are logged into the correct account.
+
+## Step-by-Step Workflow
+
+### 1. Pre-Flight Verification & Adversarial Review
+Before any release, ensure the following is completed:
+
+- **Structural Integrity**: Run `npm test` to verify layout and command mirroring.
+- **Security Check**: Run `/mindforge:security-scan` to ensure no keys or CVEs are present.
+- **Mult-Model Review**: Run `/mindforge:cross-review` to have multiple models (Claude, GPT, Gemini) audit the new features for edge cases.
+
+### 2. Versioning Strategy
+MindForge follows SemVer. Update `package.json` and `CHANGELOG.md` first.
+
+### 3. Automated Release Workflow
+MindForge provides a built-in workflow to handle the heavy lifting:
+
+1. Run the slash command: `/publish-release`
+2. Follow the interactive prompts to execute tests and dry runs.
+
+### 4. Manual Publishing (Fallback)
+If the workflow is unavailable:
+
+```bash
+npm publish --tag alpha --access public
+```
+
+### 5. Git Tagging & Origin Sync
+```bash
+git tag v[version]
+git push origin --tags
+```
+
+---
+*Last Updated: 2026-03-22*

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/quick-verify.md

@@ -0,0 +1,33 @@
+# MindForge Quick Verify (v1.0.0)
+
+Use this after installation to confirm everything works.
+
+## 1. Health check
+```
+/mindforge:health
+```
+
+## 2. Create minimal project state
+```
+/mindforge:init-project
+```
+
+## 3. Verify core files exist
+Expected:
+- `.planning/PROJECT.md`
+- `.planning/STATE.md`
+- `.planning/HANDOFF.json`
+- `.planning/AUDIT.jsonl`
+
+## 4. Optional repair
+If anything looks off:
+```
+/mindforge:health --repair
+```
+
+## 5. Clean success signal
+Run:
+```
+/mindforge:status
+```
+You should see a valid phase status and next action.

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/registry/AGENTS.md

@@ -0,0 +1,37 @@
+# MindForge — Agent Identity Registry (v6.2.0-alpha)
+
+This registry catalogs the specialized agent identities available for direct invocation and autonomous collaboration within the MindForge mesh.
+
+## 👤 Interaction Layer (Public Identifiers)
+
+| Agent | Core Persona | Interaction Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **mf-planner** | Strategic Architect | Planning & Roadmapping | "Design systems with 10/10 fidelity." |
+| **mf-executor** | Lead Developer | Feature Implementation | "Ship premium-grade code by default." |
+| **mf-reviewer** | Quality Auditor | Review & Validation | "Find the bugs before they ship." |
+| **mf-memory** | Semantic Clerk | Knowledge & History | "Manage the knowledge graph sync." |
+| **mf-researcher** | Discovery Agent | Deep Context Search | "Surface the unknown-unknowns." |
+| **mf-tool** | System Operator | CLI & Environment | "Execute system transformations safely." |
+
+## 🛡️ Specialized Sovereign Agents
+
+| Agent | Core Persona | Operational Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **security-reviewer** | Threat Hunter | Security Hardening | "Secure the framework against threats." |
+| **nyquist-auditor** | Logic Auditor | Requirement Tracing | "Ensure 100% requirement coverage." |
+| **debug-specialist** | RCA Expert | Systematic Debugging | "Debug with persistent state tracking." |
+| **ui-auditor** | Visual Designer | Aesthetic Excellence | "Ensure 10/10 aesthetics & UX." |
+| **verifier** | UAT Specialist | Evidence Validation | "Prove functionality with visual proof." |
+
+## 🧠 Autonomous Swarm Enclaves
+
+| Agent | Core Persona | Collaborative Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **qa-engineer** | Logic Guard | Adversarial Testing | "Find failure modes in the logic." |
+| **tech-writer** | Knowledge Lead | Documentation Sync | "Transform complexity into clarity." |
+| **research-agent** | Data Scraper | Recursive Discovery | "Gather data points from web/repo." |
+| **roadmapper** | Execution Lead | Milestone Sequencing | "Derive phases from requirements." |
+| **user-profiler** | Behavioral Lead | Personalized DX | "Adapt to the unique user needs." |
+
+---
+*For more details, see the [MIND-FORGE-REFERENCE-V6.md](../MIND-FORGE-REFERENCE-V6.md).*

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/registry/COMMANDS.md

@@ -0,0 +1,87 @@
+# MindForge — Command Registry (v6.2.0-alpha)
+
+This registry catalogs every strategic, operational, and governance command available in the MindForge ecosystem.
+
+## 🛡️ Strategic & Governance Commands
+
+| Command | Description | Invocation | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| `/mindforge:status` | Real-time project and Sovereign health. | `/mindforge:status` | Verified engine manifestation. |
+| `/mindforge:security-scan` | OWASP Top 10 + Sovereign Integrity check. | `/mindforge:security-scan` | Hardened codebase. |
+| `/mindforge:health` | 7-pillar diagnostic of framework integrity. | `/mindforge:health` | 100% module health report. |
+| `/mindforge:approve` | ZK-signed proof for Tier 3 gates. | `/mindforge:approve` | Unlocked high-risk commits. |
+| `/mindforge:audit` | Query historical reasoning and compliance. | `/mindforge:audit` | Traceability and audit trail. |
+| `/mindforge:tokens` | Real-time ROI and cost efficiency analysis. | `/mindforge:tokens` | Balanced resource consumption. |
+| `/mindforge:quantum-verify` | Lattice-based framework integrity check. | `/mindforge:quantum-verify` | Cryptographically proven state. |
+| `/mindforge:metrics` | Real-time velocity and quality aggregation. | `/mindforge:metrics` | Performance trends and KPIs. |
+| `/mindforge:classify` | Governance tier assignment for changes. | `/mindforge:classify` | Risk-aware gate enforcement. |
+
+## 📐 Project & Lifecycle Management
+
+| Command | Description | Invocation | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| `/mindforge:init-project` | Initialize a new project with the framework. | `/mindforge:init-project` | "Enterprise-Grade" workspace. |
+| `/mindforge:init-org` | Set up organization-level policy standards. | `/mindforge:init-org` | Standardized enterprise config. |
+| `/mindforge:new-project` | Structured project initialization wizard. | `/mindforge:new-project` | Validated project baseline. |
+| `/mindforge:milestone` | Define and track high-level milestones. | `/mindforge:milestone` | Recorded project roadmap. |
+| `/mindforge:discuss-phase` | Adaptive requirement gathering and discovery. | `/mindforge:discuss-phase` | Approved PLAN.md. |
+| `/mindforge:plan-phase` | High-fidelity execution plan generation. | `/mindforge:plan-phase` | Atomic task blueprint. |
+| `/mindforge:architecture` | Domain modeling and system design orchestration. | `/mindforge:architecture` | UI-SPEC and ARCHITECTURE docs. |
+| `/mindforge:next` | Auto-detect and route the next logical action. | `/mindforge:next` | Zero-friction dev workflow. |
+| `/mindforge:retro` | Performance-driven milestone retrospective. | `/mindforge:retro` | Identified growth areas. |
+| `/mindforge:complete-milestone` | Milestone archival and next cycle preparation. | `/mindforge:complete-milestone` | Clean project state for next. |
+
+## 🚀 Execution & Implementation
+
+| Command | Description | Invocation | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| `/mindforge:execute-phase` | Wave-based parallel implementation. | `/mindforge:execute-phase` | Completed feature phase. |
+| **mindforge:auto** | Autonomous execution mode (Wave mode). | `/mindforge:auto` | Unattended bulk task completion. |
+| `/mindforge:do` | NLP intent ingestion and dispatching. | `/mindforge:do "[intent]"` | Smart task routing. |
+| `/mindforge:steer` | Mid-execution instruction for active swarms. | `/mindforge:steer "[guide]"` | Remediated autonomous engine. |
+| `/mindforge:headless` | Daemonize MindForge for background operation. | `/mindforge:headless` | Continuous framework uptime. |
+| `/mindforge:quick` | Atomic task execution with validation. | `/mindforge:quick` | Fast, safe bugfixes and tweaks. |
+| `/mindforge:tdd` | Strict Red-Green-Refactor development logic. | `/mindforge:tdd` | 100% tested implementation. |
+| `/mindforge:swarm-execution` | Multi-agent parallel swarm orchestration. | `/mindforge:swarm-execution` | High-velocity implementation. |
+| `/mindforge:debug` | RCA investigation and systematic repair. | `/mindforge:debug` | Resolved root-cause defects. |
+| `/mindforge:workstreams` | Parallel feature track isolation and management. | `/mindforge:workstreams` | Isolated, concurrent development. |
+
+## ✅ Verification & Quality
+
+| Command | Description | Invocation | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| `/mindforge:verify-work` | UAT + Browser testing + Evidence capture. | `/mindforge:verify-work` | Visual proof of functionality. |
+| `/mindforge:validate-phase` | Pillar gap analysis and requirement closure. | `/mindforge:validate-phase` | Quality-certified phase. |
+| `/mindforge:pr-review` | AI-driven pull request review engine. | `/mindforge:pr-review` | Approved code and PR summary. |
+| `/mindforge:ui-review` | Visual audit against DESIGN_SYSTEM.md. | `/mindforge:ui-review` | 10/10 aesthetic compliance. |
+| `/mindforge:benchmark` | Measure skill and agent effectiveness. | `/mindforge:benchmark` | ROI and quality scores. |
+| `/mindforge:test-memory` | Persistent memory suite validation check. | `/mindforge:test-memory` | Knowledge graph integrity. |
+
+## 🧠 Knowledge & AI Intelligence
+
+| Command | Description | Invocation | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| `/mindforge:learn` | Convert raw knowledge into a SKILL.md. | `/mindforge:learn` | New framework capability. |
+| `/mindforge:remember` | Management of the semantic knowledge graph. | `/mindforge:remember` | Evolving framework intelligence. |
+| `/mindforge:memory` | Real-time interaction with framework memory. | `/mindforge:memory` | Semantic context retrieval. |
+| `/mindforge:research` | Deep research across the 1M token window. | `/mindforge:research` | Comprehensive context reports. |
+| `/mindforge:hindsight` | Inject fixes into past state points. | `/mindforge:hindsight` | Repaired state history. |
+| `/mindforge:harvest` | Proactive semantic intent harvesting. | `/mindforge:harvest` | Automated task claiming. |
+| `/mindforge:self-heal` | Autonomous reasoning drift remediation. | `/mindforge:self-heal` | Stabilized swarm logic. |
+| `/mindforge:temporal` | State history and time-travel debugging. | `/mindforge:temporal` | Advanced state traceability. |
+
+## 📦 Skill & Asset Management
+
+| Command | Description | Invocation | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| `/mindforge:install-skill` | Install a skill to the designated Tier. | `/mindforge:install-skill` | Deployed capability. |
+| `/mindforge:register-skill` | Register skill in the framework Manifest. | `/mindforge:register-skill` | Discoverable skill asset. |
+| `/mindforge:audit-skill` | Record lifecycle events in the audit log. | `/mindforge:audit-skill` | Compliance and history. |
+| `/mindforge:validate-skill` | High-fidelity skill testing and linting. | `/mindforge:validate-skill` | Certified skill performance. |
+| `/mindforge:marketplace` | Discover and install community skills. | `/mindforge:marketplace` | Ecosystem expansion. |
+| `/mindforge:spawn` | Direct invocation of a persona essence. | `/mindforge:spawn [persona]` | Cognitive support on demand. |
+| `/mindforge:identity` | Invoke specialized identity from /agents/. | `/mindforge:identity` | Specialized interaction persona. |
+| `/mindforge:plugins` | Manage and audit framework logic plugins. | `/mindforge:plugins` | Customizable framework engine. |
+
+---
+*For more details, see the [MIND-FORGE-REFERENCE-V6.md](../MIND-FORGE-REFERENCE-V6.md).*

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/registry/HOOKS.md

@@ -0,0 +1,38 @@
+# MindForge — Hook Registry (v6.2.0-alpha)
+
+This registry catalogs the automation and security lifecycle hooks available in the MindForge environment.
+
+## 🛡️ Framework Governance Hooks
+
+| Hook | Trigger Event | Primary Security Protocol |
+| :--- | :--- | :--- |
+| **mindforge-session-init_extended** | `Session Start` | "Enterprise-grade context restoration, workspace mounting, and security baseline verification." |
+| **mindforge-workflow-guard** | `Command Invocation` | "Enforcement of phase-based logic, mandatory plan approval, and verification gating." |
+| **mindforge-prompt-guard** | `Token Input` | "Persona integrity enforcement, safety filtering, and prompt injection prevention." |
+
+## 📊 Operational Visibility & Health
+
+| Hook | Trigger Event | Primary Security Protocol |
+| :--- | :--- | :--- |
+| **mindforge-statusline** | `Terminal Init / Loop` | "Real-time productivity indicators, token counts, and phase status rendering." |
+| **mindforge-check-update** | `Startup / Interval` | "Automatic framework update detection, changelog retrieval, and version sync." |
+| **mindforge-context-monitor** | `Context Shift` | "Dynamic token optimization, context window management, and memory prioritizing." |
+
+## 🔗 Version Control & Git Hooks
+
+| Hook | Trigger Event | Primary Security Protocol |
+| :--- | :--- | :--- |
+| **pre-commit-security** | `git commit` | "Run a `--secrets` scan on staged files before commit." |
+| **post-merge-status** | `git merge` | "Re-verify Sovereign framework integrity after code updates." |
+| **pre-push-validation** | `git push` | "Validate that all active plans have an 'Approved' status." |
+
+## 🧠 Reasoning & Memory Hooks
+
+| Hook | Trigger Event | Primary Security Protocol |
+| :--- | :--- | :--- |
+| **nexus-tracer-init** | `Async Start` | "Inject the ZTAI signing protocol into every reasoning cycle." |
+| **memory-load-check** | `Session Start` | "Verify the knowledge graph's semantic integrity." |
+| **intent-harvest-trigger** | `Idle Threshold` | "Activate the Sovereign Homing engine for idle task-claiming." |
+
+---
+*For more details, see the [MIND-FORGE-REFERENCE-V6.md](../MIND-FORGE-REFERENCE-V6.md).*

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/registry/PERSONAS.md

@@ -0,0 +1,64 @@
+# MindForge — Persona Registry (v6.2.0-alpha)
+
+This registry catalogs the specialized agent essences available for direct interaction and autonomous reasoning.
+
+## 🧠 Strategic Reason Enclaves
+
+| Persona | Identifier | Cognitive Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **mf-planner** | Strategic Planner | Minimalism & Scalability | "Design systems with 10/10 fidelity and 1/1 complexity." |
+| **architect** | Senior Architect | Core System Design | "Build robust, secure, and maintainable foundations." |
+| **roadmapper** | Milestone Specialist | Timeline & Dependencies | "Convert requirements into executable milestones." |
+| **analyst** | Requirements Lead | Scoping & Specs | "Translate ambiguous intent into precise, testable specifications." |
+| **decision-architect** | Governance Lead | Implementation Verdicts | "Synthesize research and audits into actionable roadmap adjustments." |
+| **advisor-researcher** | Trade-off Consultant | Comparative Rationale | "Research single decision points and provide structured comparisons." |
+
+## 🚀 Implementation Pilots
+
+| Persona | Identifier | Cognitive Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **mf-executor** | Lead Developer | "Enterprise-Grade" Logic & UI | "Ship premium-grade code with 100% test coverage." |
+| **developer** | Code Smith | Clean Code & Patterns | "Implement features according to the approved plan." |
+| **executor** | Pilot Developer | Atomic Multi-Plan | "Executes implementation plans with high fidelity and atomic commits." |
+| **tech-writer** | Documentation Lead | Clarity & Accuracy | "Transform engineering complexity into readable documentation." |
+| **mf-tool** | System Operator | Terminal & File Ops | "Execute complex system transformations safely." |
+
+## 🛡️ Quality & Security Auditors
+
+| Persona | Identifier | Cognitive Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **mf-reviewer** | Quality Lead | Correctness & Performance | "Find the bugs and antipatterns before they ship." |
+| **security-reviewer** | Threat Hunter | PQAS & OWASP | "Harden the framework against all agentic threats." |
+| **nyquist-auditor** | Requirement Auditor | Gaps & Edge Cases | "Ensure every requirement has a verification plan." |
+| **verifier** | UAT Specialist | Evidence & Validation | "Prove the feature works with visual evidence." |
+| **qa-engineer** | QA Specialist | Adversarial Testing | "Think adversarially to find failure modes and logic gaps." |
+| **ui-auditor** | Visual Specialist | Aesthetic Excellence | "Ensure 10/10 aesthetics and fluid animations." |
+| **ui-checker** | Design Validator | UI-SPEC Compliance | "Verify visual implementation against recorded design contracts." |
+| **integration-checker** | System Integrator | Cross-Component Flow | "Ensure disparate services work as a unified system." |
+| **coverage-specialist** | Testing Analyst | Coverage Gap Index | "Identify untested code paths and logic branches." |
+
+## 🔍 Research & Intelligence Agents
+
+| Persona | Identifier | Cognitive Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **mf-researcher** | Knowledge Lead | Context & Discovery | "Surface the unknown-unknowns before implementation." |
+| **project-researcher** | Principal Researcher | Ecosystem & Feasibility | "Investigate technical constraints before project or milestone creation." |
+| **research-agent** | Deep-Dive Specialist | Recursive Investigation | "Gather data points from the web and codebase recursively." |
+| **research-synthesizer** | Wisdom Aggregator | Summary Generation | "Synthesize research outputs from multiple agents into a SUMMARY.md." |
+| **phase-researcher** | Tactical Researcher | Implementation Logic | "Analyze approaches and best practices for the current phase." |
+| **ui-researcher** | Design Consultant | Visual Trend Analysis | "Research modern UI patterns and aesthetic benchmarks." |
+
+## 🧠 Specialized Diagnostics & Memory
+
+| Persona | Identifier | Cognitive Focus | Primary Directive |
+| :--- | :--- | :--- | :--- |
+| **mf-memory** | Semantic Clerk | Persistent Context | "Manage long-term memory and knowledge graph synchronization." |
+| **debug-specialist** | RCA Expert | Root Cause Analysis | "Debug systematically with persistent state tracking." |
+| **debugger** | Logic Specialist | Hypothesis Testing | "Solve failures through scientific hypothesis testing." |
+| **user-profiler** | Behavioral Analyst | Dev Experience | "Adapt the framework to the unique needs of the developer." |
+| **assumptions-analyzer** | Logic Auditor | Pre-Planning Verification | "Surface approach assumptions before committing to a plan." |
+| **codebase-mapper** | Ecosystem Explorer | Semantic Indexing | "Generate structured documentation for any repository." |
+| **release-manager** | Pipeline Lead | SemVer & Ship Control | "Ensure every release is traceable and reversible." |
+
+---
+*For more details, see the [MIND-FORGE-REFERENCE-V6.md](../MIND-FORGE-REFERENCE-V6.md).*

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/registry/README.md

@@ -0,0 +1,27 @@
+# MindForge — Documentation Registry Hub (v6.2.0-alpha)
+
+Welcome to the central high-fidelity registry for the MindForge framework. This hub provides 100% transparency into the specialized assets, cognitive patterns, and automated guards that power the environment.
+
+## 🗂️ Framework Registries
+
+| Registry | Content Scope | Primary Purpose |
+| :--- | :--- | :--- |
+| **[COMMANDS.md](./COMMANDS.md)** | 64+ Core Operations | Direct terminal interaction reference. |
+| **[SKILLS.md](./SKILLS.md)** | 70+ Atomic Skills | Distributed capability and tool mappings. |
+| **[PERSONAS.md](./PERSONAS.md)** | 35+ Cognitive Egos | Specialized agent reasoning configurations. |
+| **[WORKFLOWS.md](./WORKFLOWS.md)** | 100+ Automations | High-fidelity lifecycle and task flows. |
+| **[HOOKS.md](./HOOKS.md)** | 10+ Framework Guards | Security, visibility, and automation triggers. |
+| **[AGENTS.md](./AGENTS.md)** | 20+ Digital Identities | Invocable personas and internal swarms. |
+
+## 🚀 "Enterprise-Grade" Ready
+
+These registries are synchronized automatically during every `mindforge init` or `update` cycle. They ensure that every framework capability is discoverable, verifiable, and enforceable by both human developers and AI agents.
+
+## 🔍 How to Use This Hub
+
+1.  **Search**: Use `Ctrl+F` across any registry to find specific functional keywords.
+2.  **Invoke**: Use the "Trigger Commands" in [WORKFLOWS.md](./WORKFLOWS.md) for automated task orchestration.
+3.  **Audit**: Cross-reference [HOOKS.md](./HOOKS.md) to understand the security guards active in your session.
+
+---
+*MindForge v6.2.0-alpha — Absolute Sovereignty. Absolute Performance. Absolute Transparency.*

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/registry/SKILLS.md

@@ -0,0 +1,142 @@
+# MindForge — Skill Registry (v6.2.0-alpha)
+
+This registry catalogs the high-fidelity SkillStacks available to the MindForge Intelligence Mesh.
+
+## 🧠 Technical Architecture & Engineering
+
+| Skill | Primary Domain | Primary Capability |
+| :--- | :--- | :--- |
+| **agency-senior-developer** | Implementation | "Enterprise-Grade" styling and robust logic. |
+| **agency-software-architect** | System Design | Architectural pattern selection and complexity control. |
+| **agency-backend-architect** | Core Logic | Database schema design and high-performance API logic. |
+| **agency-frontend-developer** | Web Interface | Fluid components and interactive design systems. |
+| **agency-mobile-app-builder** | Native Apps | Multi-platform mobile development (iOS/Android). |
+
+## 🛡️ Security & Compliance
+
+| Skill | Primary Domain | Primary Capability |
+| :--- | :--- | :--- |
+| **agency-security-engineer** | Hardening | Threat detection and post-quantum security modeling. |
+| **agency-blockchain-security** | Smart Contracts | Vulnerability detection and formal verification. |
+| **agency-compliance-auditor** | Regulation | SOC 2 / ISO 27001 readiness and evidence gathering. |
+| **agency-legal-compliance** | Legal | Jurisdiction-aware data handling and licensing review. |
+
+## 🤖 AI & Data Intelligence
+
+| Skill | Primary Domain | Primary Capability |
+| :--- | :--- | :--- |
+| **agency-ai-engineer** | ML Integration | Agentic steering and model optimization. |
+| **agency-data-engineer** | Pipelines | Scalable ETL/ELT and lakehouse architecture. |
+| **agency-database-optimizer** | Performance | Query optimization and indexing strategies. |
+| **agency-analytics-reporter** | Insights | Data-driven storytelling and KPI dashboards. |
+
+## 🎨 Design & Experience
+
+| Skill | Primary Domain | Primary Capability |
+| :--- | :--- | :--- |
+| **agency-ui-designer** | Visual Identity | Pixel-perfect components and consistent branding. |
+| **agency-ux-architect** | Human Interface | Fluid animations and intuitive user flows. |
+| **agency-whimsy-injector** | Personality | Interactive delight and playful brand experiences. |
+
+## 🛠️ MindForge Atomic Skills (Exhaustive)
+
+These atomic skills are the underlying mechanics of the framework, providing specialized capabilities across the entire project lifecycle.
+
+### 🔄 Core & Lifecycle Management
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-next` | Automatically advance to the next logical step in the workflow. |
+| `mindforge-progress` | Check project progress, show context, and route to next action. |
+| `mindforge-status` | Display a rich dashboard of active project state and readiness. |
+| `mindforge-help` | Show available commands and comprehensive usage guides. |
+| `mindforge-update` | Update MindForge to the latest version with changelog analysis. |
+| `mindforge-settings` | Configure framework toggles, security gates, and model profiles. |
+| `mindforge-session-report` | Generate post-session summaries and resource consumption analysis. |
+| `mindforge-stats` | Display metrics, git velocity, and project timelines. |
+
+### ♟️ Strategic Planning & Research
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-brainstorming` | Must use before creative work to explore requirements and design. |
+| `mindforge-research-phase` | Deep research for technical implementation strategies. |
+| `mindforge-map-codebase` | Parallel codebase mapping and semantic index creation. |
+| `mindforge-milestone-summary` | Comprehensive project onboarding and overview generation. |
+| `mindforge-discuss-phase` | Context gathering via adaptive stakeholder questioning. |
+| `mindforge-plan-phase` | Create detailed documentation (PLAN.md) with verification loops. |
+| `mindforge-plan-phase_extended` | Multi-step planning from specs and complex requirements. |
+| `mindforge-plan-milestone-gaps` | Close roadmap gaps identified during milestone audits. |
+| `mindforge-list-phase-assumptions` | Surface approach assumptions before committing to a plan. |
+
+### 🚀 Implementation & Execution
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-execute-phase` | High-velocity implementation with wave-based parallelization. |
+| `mindforge-execute-phase_extended` | Multi-session implementation with state-preservation checkpoints. |
+| `mindforge-swarm-execution` | Execute independent tasks simultaneously within a session. |
+| `mindforge-tdd` | Strict Red-Green-Refactor test-driven development. |
+| `mindforge-tdd_extended` | Advanced TDD for complex features and obscure bugfixes. |
+| `mindforge-fast` | Trivial task execution with zero framework overhead. |
+| `mindforge-do` | Smart natural language dispatcher for automated routing. |
+| `mindforge-manager` | Interactive command center for multi-phase orchestration. |
+| `mindforge-ui-phase` | Generate a high-fidelity UI Design Contract (UI-SPEC.md). |
+
+### ✅ Quality, Verification & Ship
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-verify-work` | Validate built features through conversational UAT. |
+| `mindforge-verify-work_extended` | Evidence-first verification (proof before assertions). |
+| `mindforge-ui-review` | Retroactive 6-pillar visual and accessibility audit. |
+| `mindforge-debug` | Systematic debugging with persistent session state. |
+| `mindforge-debug_extended` | Deep root-cause analysis (RCA) for complex failures. |
+| `mindforge-validate-phase` | Fill Nyquist validation gaps for completed work. |
+| `mindforge-audit-milestone` | Verify completion against original strategic intent. |
+| `mindforge-audit-uat` | Cross-phase audit of all outstanding verification items. |
+| `mindforge-review-request` | Verify requirements compliance before branch merge. |
+| `mindforge-review-inbound` | Technical audit of received code review feedback. |
+| `mindforge-pr-branch` | Create clean PR branches (filtering internal framework noise). |
+| `mindforge-ship` | Full release pipeline (PR, review, and merge). |
+| `mindforge-ship_extended` | Integration decision engine for completed implementation. |
+
+### 🛠️ Environment & Workspace
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-new-project` | Deep-research project initialization and setup. |
+| `mindforge-new-milestone` | Initialize new milestone cycles and update PROJECT.md. |
+| `mindforge-new-workspace` | Create isolated repositories with independent planning state. |
+| `mindforge-workspace-isolated` | Git worktree creation for clean feature isolation. |
+| `mindforge-list-workspaces` | Display all active MindForge workspaces and their health. |
+| `mindforge-remove-workspace` | Safe cleanup of workspaces and associated worktrees. |
+| `mindforge-resume-work` | Full context restoration from previous session state. |
+| `mindforge-pause-work` | Mid-phase handoff creation for session suspension. |
+| `mindforge-cleanup` | Archive phase directories from completed milestones. |
+| `mindforge-workstreams` | Manage parallel feature tracks with isolated state. |
+| `mindforge-add-backlog` | Park speculative ideas in the "Parking Lot" (999.x). |
+| `mindforge-review-backlog` | Promote backlog items to the active milestone roadmap. |
+| `mindforge-add-phase` | Append new phases to the current milestone. |
+| `mindforge-insert-phase` | Insert urgent decimal phases (e.g. 72.1) dynamically. |
+| `mindforge-remove-phase` | Remove future phases and automatically renumber roadmap. |
+| `mindforge-add-todo` | Capture real-time tasks from the conversation context. |
+| `mindforge-note` | Zero-friction idea capture and observation log. |
+| `mindforge-plant-seed` | Forward-looking idea capture with trigger conditions. |
+
+### 🧠 Intelligence & Memory
+
+| Skill | Description |
+| :--- | :--- |
+| `mindforge-neural-orchestrator` | Automated skill discovery and tool invocation protocol. |
+| `mindforge-thread` | Persistent cross-session context and thread management. |
+| `mindforge-memory` | Semantic clerk for long-term knowledge graph access. |
+| `mindforge-skill-creation` | Learn, validate, and commit new framework capabilities. |
+| `mindforge-forensics` | Post-mortem analysis of failed workflows and state. |
+| `mindforge-system-architecture` | Multi-service design and scaling decision support. |
+| `mindforge-profile-user` | Generate and maintain developer behavioral profiles. |
+| `mindforge-reapply-patches` | Restore local modifications after framework updates. |
+| `mindforge-join-discord` | Direct community integration and support access. |
+
+---
+*For more details, see the [MIND-FORGE-REFERENCE-V6.md](../MIND-FORGE-REFERENCE-V6.md).*

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/registry/WORKFLOWS.md

@@ -0,0 +1,72 @@
+# MindForge — Workflow Registry (v6.2.0-alpha)
+
+This registry catalogs the automated interaction flows available in the MindForge environment.
+
+## 🧱 Initialization & Setup
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:init-project** | `/mindforge:init-project` | "Context extraction -> Framework initialization -> Baseline." | New MindForge project. |
+| **mindforge:init-org** | `/mindforge:init-org` | "Organization-level standards -> Shared-configs -> Policies." | Standardized enterprise org. |
+| **mindforge:new-runtime** | `/mindforge:new-runtime` | "Environment detection -> SDK scaffolding -> Test-loop." | Support for new target AI coding runtime. |
+| **forge:init-project** | `/forge:init-project` | "FORGE-framework initialization -> Local deployment." | FORGE-ready workspace. |
+
+## 🧠 Strategic Planning & Discovery
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:brainstorming** | `/mindforge:brainstorming` | "Intent exploration -> Requirement discovery -> Spec-generation." | Approved requirements. |
+| **mindforge:milestone** | `/mindforge:milestone` | "Requirement clustering -> Timeline generation -> Slotting." | Recorded PROJECT.md roadmap. |
+| **mindforge:architecture** | `/mindforge:architecture` | "Domain modeling -> Pattern selection -> Interface contract." | ARCHITECTURE and UI-SPEC docs. |
+| **mindforge:discuss-phase** | `/mindforge:discuss-phase` | "Adaptive context gathering -> Assumption analysis -> Planning." | Approved PLAN.md. |
+| **mindforge:plan-phase** | `/mindforge:plan-phase` | "Multi-phase blueprinting -> Security review -> Dependency check." | Approved implementation plan. |
+| **mindforge:planner** | `/mindforge:planner` | "Invoke mf-planner -> Logic verification -> Minimization." | Strategic planning support. |
+| **mindforge:researcher** | `/mindforge:researcher` | "Invoke mf-researcher -> Deep context search -> Summary." | Contextual research summaries. |
+
+## 🚀 Execution & Implementation
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:execute-phase** | `/mindforge:execute-phase` | "Wave processing -> Parallel execution -> Swarm implementation." | Completed feature phase. |
+| **mindforge:workstreams** | `/mindforge:workstreams` | "Feature track isolation -> Git Worktree sync -> PR-ready." | Parallel feature development. |
+| **mindforge:tdd** | `/mindforge:tdd` | "Test-definition -> Implementation -> Refactor-cycle." | 100% tested feature code. |
+| **mindforge:executor** | `/mindforge:executor` | "Invoke mf-executor -> Logic implementation -> Atomic commits." | High-fidelity execution assistance. |
+| **mindforge:do** | `/mindforge:do` | "NLP intent routing -> Dispatcher -> Command execution." | Smart, intent-based action. |
+| **mindforge:auto** | `/mindforge:auto` | "Autonomous wave execution -> Self-correcting loop -> Sync." | Bulk, unattended execution. |
+| **mindforge:debug** | `/mindforge:debug` | "RCA investigation -> Log analysis -> Systematic repair." | Resolution of complex defects. |
+| **mindforge:quick** | `/mindforge:quick` | "Atomic task execution -> Validation -> Immediate commit." | Ultra-fast trivial changes. |
+| **mindforge:steer** | `/mindforge:steer` | "Engine interception -> Mid-execution guidance -> Adaptation." | Corrected autonomous engine flow. |
+
+## 🛡️ Verification & Quality
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:health** | `/mindforge:health` | "Component diagnostics -> Config-audit -> Self-repair." | Balanced system health state. |
+| **mindforge:validate-phase** | `/mindforge:validate-phase` | "Pillar gap analysis -> Requirement tracing -> Closure." | Validated and archived phase. |
+| **mindforge:pr-review** | `/mindforge:pr-review` | "Diff analysis -> Security check -> Performance-audit." | Quality-assured code review. |
+| **mindforge:security-scan** | `/mindforge:security-scan` | "Threat detection -> Hardcoding check -> OWASP auditing." | Hardened system security. |
+| **mindforge:metrics** | `/mindforge:metrics` | "Quality trends -> Speed index -> Efficiency scores." | Real-time performance insights. |
+| **mindforge:tokens** | `/mindforge:tokens` | "Consumption profile -> Cost analysis -> Optimization paths." | Optimized framework operation. |
+| **mindforge:reviewer** | `/mindforge:reviewer` | "Invoke mf-reviewer -> Independent quality check." | High-confidence code audit. |
+| **mindforge:audit** | `/mindforge:audit` | "Structured log analysis -> Integration query -> History." | Comprehensive event traceability. |
+
+## 📦 Release & Shipping
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:ship** | `/mindforge:ship` | "PR generation -> Documentation sync -> Release tagging." | Merged features and updated docs. |
+| **mindforge:release** | `/mindforge:release` | "Framework sync -> SemVer bump -> Global distribution." | New framework version release. |
+| **mindforge:complete-milestone** | `/mindforge:complete-milestone` | "Verification -> Archival -> Next-milestone setup." | Archived milestone and prep-next. |
+| **publish-release** | `/publish-release` | "Build orchestration -> Registry sync -> Distribution." | Deployed version to distribution hub. |
+
+## 🧠 Knowledge & AI Intelligence
+
+| Workflow | Trigger Command | Logic Summary | Outcome Goal |
+| :--- | :--- | :--- | :--- |
+| **mindforge:learn** | `/mindforge:learn` | "Source ingestion -> Validation -> Reusable skill creation." | New framework capability (SKILL.md). |
+| **mindforge:remember** | `/mindforge:remember` | "Knowledge graph sync -> Semantic association -> Growth." | Evolving framework IQ. |
+| **mindforge:memory** | `/mindforge:memory` | "Invoke mf-memory -> Persistent context retrieval." | Real-time knowledge graph interaction. |
+| **mindforge:research** | `/mindforge:research` | "Deep context ingestion (Gemini) -> Logic synthesis." | Comprehensive research artifacts. |
+
+---
+*For more details, see the [MIND-FORGE-REFERENCE-V6.md](../MIND-FORGE-REFERENCE-V6.md).*

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/release-checklist-guide.md

@@ -0,0 +1,37 @@
+# MindForge Release Checklist Guide (v1.0.0)
+
+This guide explains how to complete the production readiness checklist
+in `.mindforge/production/production-checklist.md` and log results in
+`.planning/RELEASE-CHECKLIST.md`.
+
+## How to use
+1. Open `.mindforge/production/production-checklist.md`
+2. For each item, run the **Verification step** exactly
+3. Record results in `.planning/RELEASE-CHECKLIST.md`
+
+## What “✅ verified” means
+An item is only ✅ when:
+- The verification step was executed
+- The result was successful
+- The verifier and date were recorded
+
+## Recommended order
+1. **Section A** — Installation & upgrade (local + global)
+2. **Section B** — Command coverage
+3. **Section C** — Governance gates
+4. **Section D** — Documentation
+5. **Section E** — Test coverage
+6. **Section F** — Release artifacts
+
+## Example entry
+```
+| A03 | ✅ | dev@example.com | 2026-03-22 | Local install verified |
+```
+
+## Common pitfalls
+- Marking ✅ without running the command
+- Skipping CI checks (E09/F03) before tagging
+- Forgetting to update SDK version to match root
+
+## Final release gate
+Do not tag or publish until **all 55 items** are ✅.

package/.mindforge/mirrors/mirror-sre-776a1cf9/docs/requirements.md

@@ -0,0 +1,29 @@
+# MindForge Requirements (v1.0.0)
+
+Use this checklist before installation to avoid surprises.
+
+## System requirements
+- **Node.js:** 18+ (20 LTS recommended)
+- **Git:** 2.30+
+- **OS:** macOS, Linux, or Windows (WSL supported)
+- **Disk:** ~200MB free for framework + caches
+
+## Runtime requirements
+- **Claude Code** or **Antigravity** installed and working
+- Network access to npm registry for `npx mindforge-cc@latest`
+
+## Optional (but recommended)
+- `jq` for audit log queries
+- `gh` CLI for GitHub release workflows
+
+## Quick environment check
+```bash
+node -v
+npm -v
+git --version
+```
+
+## If you are in CI
+- Ensure `CI=true`
+- Use a Node 20 image
+- Keep `.planning/` writable