π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Checkpoint: File edits
rUvdf2932c949c7
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.jsonindex abc973b4a0..86c8d3fd6c 100644--- a/v3/@claude-flow/cli/package.json+++ b/v3/@claude-flow/cli/package.json@@ -85,6 +85,7 @@},"dependencies": {"@claude-flow/aidefence": "^3.0.2",+ "@claude-flow/guidance": "^3.0.0-alpha.1","@claude-flow/mcp": "^3.0.0-alpha.8","@claude-flow/shared": "^3.0.0-alpha.1","@noble/ed25519": "^2.1.0"diff --git a/v3/implementation/adrs/ADR-045-guidance-system-v31-integration.md b/v3/implementation/adrs/ADR-045-guidance-system-v31-integration.mdnew file mode 100644index 0000000000..c4f2bb8929--- /dev/null+++ b/v3/implementation/adrs/ADR-045-guidance-system-v31-integration.md@@ -0,0 +1,127 @@+# ADR-045: Guidance System Integration β Claude Flow v3.1++**Status:** Accepted+**Date:** 2026-02-02+**Author:** Claude Flow Architecture+**Version:** 3.1.0-alpha.1++## Context++The `@claude-flow/guidance` package (published as `3.0.0-alpha.1`) provides a governance control plane for Claude Code sessions:++- **Compile**: CLAUDE.md β Constitution + Rule Shards + Rule Manifest+- **Enforce**: 4 enforcement gates (ingestion, retrieval, generation, emission)+- **Prove**: Proof envelopes with cryptographic audit trail+- **Evolve**: Automatic rule evolution and optimization+- **Analyze**: 6-dimension scoring (Structure, Coverage, Enforceability, Compilability, Clarity, Completeness)+- **A/B Test**: Headless comparative testing of governance configurations+- **Templates**: 6 CLAUDE.md templates (minimal, standard, full, security, performance, solo)++Currently, `@claude-flow/guidance` is:+1. A standalone package at `v3/@claude-flow/guidance/`+2. Used by `@claude-flow/cli` via dynamic `import()` β but NOT declared as a dependency+3. Not included in the umbrella `claude-flow` package's `files` array+4. Not available to end users running `npx claude-flow@alpha`++This means the `guidance` CLI commands silently fail at runtime when installed from npm.++## Decision++Integrate `@claude-flow/guidance` as a **first-class dependency** in both `@claude-flow/cli` and the `claude-flow` umbrella package, making it a core component of Claude Flow v3.1.++### 1. Dependency Graph++```+claude-flow (umbrella v3.1.0-alpha.1)+ βββ @claude-flow/cli (v3.1.0-alpha.1)+ βββ @claude-flow/guidance (v3.0.0-alpha.1) β NEW+ βββ @claude-flow/shared+ βββ @claude-flow/mcp+ βββ @claude-flow/aidefence+```++### 2. Package Changes++**`@claude-flow/cli/package.json`**:+```json+{+ "dependencies": {+ "@claude-flow/guidance": "^3.0.0-alpha.1"+ }+}+```++**`claude-flow/package.json` (umbrella)**:+```json+{+ "files": [+ "v3/@claude-flow/guidance/dist/**/*.js",+ "v3/@claude-flow/guidance/dist/**/*.d.ts",+ "v3/@claude-flow/guidance/package.json"+ ]+}+```++### 3. CLI Commands (6 subcommands)++The `guidance` command becomes a top-level CLI command with 6 subcommands:++| Subcommand | Description |+|------------|-------------|+| `guidance compile` | Compile CLAUDE.md into constitution + shards + manifest |+| `guidance retrieve` | Query compiled rule shards by semantic similarity |+| `guidance gates` | Run enforcement gates against tool calls |+| `guidance evolve` | Evolve rules based on session outcomes |+| `guidance optimize` | Analyze and optimize CLAUDE.md for higher governance score |+| `guidance ab-test` | Run A/B comparative benchmark between configurations |++### 4. Init System Integration++The CLAUDE.md generator (`claudemd-generator.ts`) now:+- Produces analyzer-validated A-grade templates (91-95/100)+- Supports 6 template variants via `runtime.claudeMdTemplate` option+- Uses enforceable bullet-format rules (100% enforceability score)+- Is selectable during `init --wizard`++### 5. Version Strategy++| Package | Current | v3.1 |+|---------|---------|------|+| `claude-flow` (umbrella) | 3.0.0-alpha.185 | 3.1.0-alpha.1 |+| `@claude-flow/cli` | 3.0.0-alpha.185 | 3.1.0-alpha.1 |+| `@claude-flow/guidance` | 3.0.0-alpha.1 | 3.0.0-alpha.1 (unchanged) |++The guidance package itself stays at 3.0.0-alpha.1 since its API is stable. The CLI and umbrella bump to 3.1.0 to reflect the governance integration as a feature milestone.++## Consequences++### Positive+- `guidance` commands work out-of-the-box for all users+- CLAUDE.md quality is measurable and enforceable+- A/B testing enables data-driven governance improvement+- Template system gives users appropriate defaults for their use case+- Init wizard can offer template selection++### Negative+- Increases install size (~200KB for guidance dist)+- Adds a build-order dependency (guidance must build before CLI)++### Neutral+- Dynamic imports remain (lazy loading for faster CLI startup)+- Guidance package can still evolve independently++## Implementation++1. Add `@claude-flow/guidance` to CLI's `dependencies`+2. Add guidance dist files to umbrella's `files` array+3. Version bump CLI and umbrella to 3.1.0-alpha.1+4. Update init wizard to offer template selection+5. Publish all packages with correct dist-tags++## Related ADRs++- ADR-G001: Guidance Control Plane+- ADR-G002: Constitution-Shard Split+- ADR-G004: Four Enforcement Gates+- ADR-G009: Headless Testing Harness+- ADR-026: Agent Booster Model Routing (3-tier system referenced in templates)