mirror of
https://github.com/proffesor-for-testing/agentic-qe.git
synced 2026-09-19 08:45:47 +08:00
docs(contributing): clarify ruflo/claude-flow are dev-time tooling, not runtime deps (M3.4)
CLAUDE.md references ruflo/claude-flow MCP tools heavily, which can read as a runtime dependency. It isn't: the shipped agentic-qe package imports only @ruvector/* primitives + two optional @claude-flow peers, never the ruflo npm package. Adds a CONTRIBUTING note so contributors don't wire product code to a ruflo CLI/MCP call or add it as a runtime dep. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -209,6 +209,22 @@ When developing agents, you're creating:
|
||||
3. MCP handlers in `src/mcp/handlers/`
|
||||
4. Tests in `tests/agents/` and `tests/integration/`
|
||||
|
||||
### `ruflo` / `claude-flow` are dev-time tooling, NOT runtime dependencies
|
||||
|
||||
The `CLAUDE.md` in this repo references `ruflo`/`claude-flow` MCP tools heavily —
|
||||
this can read as if the shipped package depends on them. It does not. Those tools
|
||||
are **development-time coordination tooling** used by Claude Code sessions that
|
||||
*work on* AQE (swarm init, memory, hooks). The published `agentic-qe` package does
|
||||
**not** import the `ruflo` npm package at all — check `package.json`: runtime deps
|
||||
are `@ruvector/*` primitives (attention, gnn, learning-wasm, router, rvf-node,
|
||||
sona) plus two **optional** `@claude-flow/*` peers (`browser`, `guidance`). So:
|
||||
|
||||
- `npm ls ruflo` in this repo is correctly empty.
|
||||
- Don't add `ruflo` as a runtime dependency, and don't wire product code to a
|
||||
`ruflo` CLI/MCP call — that coupling doesn't exist and shouldn't be introduced.
|
||||
- Learning-integrity work (flywheel, witness chain, provenance) is built *in this
|
||||
repo* (`src/learning/`), inspired by ruflo's ADRs but not importing them.
|
||||
|
||||
### Installation Steps
|
||||
|
||||
1. **Clone the repository:**
|
||||
|
||||
Reference in New Issue
Block a user