From 702eee1fdd2cab892ef145b04776734f03ace5c6 Mon Sep 17 00:00:00 2001 From: Cristian Magherusan-Stanciu Date: Mon, 28 Sep 2026 18:45:46 +0200 Subject: [PATCH 1/2] docs: trim RuFlo boilerplate from CLAUDE.md Drop the claude-flow swarm, routing, CLI, memory and agent-catalog sections, the TodoWrite/concurrency rules and the claude-flow security scan line. None beyond the removals; file organization and build commands already matched this repo. Closes #2106 --- CLAUDE.md | 162 +----------------------------------------------------- 1 file changed, 1 insertion(+), 161 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index e153a9280..25c9d96b6 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,4 +1,4 @@ -# Claude Code Configuration - RuFlo V3 +# CLAUDE.md ## Behavioral Rules (Always Enforced) @@ -7,7 +7,6 @@ - ALWAYS prefer editing an existing file to creating a new one - NEVER proactively create documentation files (*.md) or README files unless explicitly requested - NEVER save working files, text/mds, or tests to the root folder -- Never continuously check status after spawning a swarm — wait for results - ALWAYS read a file before editing it - NEVER commit secrets, credentials, or .env files @@ -34,14 +33,6 @@ - Use event sourcing for state changes - Ensure input validation at system boundaries -### Project Config - -- **Topology**: hierarchical-mesh -- **Max Agents**: 15 -- **Memory**: hybrid -- **HNSW**: Enabled -- **Neural**: Enabled - ## Go Module Notes - This project does NOT use a vendor directory. Do not use `go mod vendor`. @@ -219,132 +210,6 @@ set for multi-close PRs). - NEVER commit .env files or any file containing secrets - Always validate user input at system boundaries - Always sanitize file paths to prevent directory traversal -- Run `npx @claude-flow/cli@latest security scan` after security-related changes - -## Concurrency: 1 MESSAGE = ALL RELATED OPERATIONS - -- All operations MUST be concurrent/parallel in a single message -- Use Claude Code's Task tool for spawning agents, not just MCP -- ALWAYS batch ALL todos in ONE TodoWrite call (5-10+ minimum) -- ALWAYS spawn ALL agents in ONE message with full instructions via Task tool -- ALWAYS batch ALL file reads/writes/edits in ONE message -- ALWAYS batch ALL Bash commands in ONE message - -## Swarm Orchestration - -- MUST initialize the swarm using CLI tools when starting complex tasks -- MUST spawn concurrent agents using Claude Code's Task tool -- Never use CLI tools alone for execution — Task tool agents do the actual work -- MUST call CLI tools AND Task tool in ONE message for complex work - -### 3-Tier Model Routing (ADR-026) - -| Tier | Handler | Latency | Cost | Use Cases | -| ------ | --------- | --------- | ------ | ----------- | -| **1** | Agent Booster (WASM) | <1ms | $0 | Simple transforms (var→const, add types) — Skip LLM | -| **2** | Haiku | ~500ms | $0.0002 | Simple tasks, low complexity (<30%) | -| **3** | Sonnet/Opus | 2-5s | $0.003-0.015 | Complex reasoning, architecture, security (>30%) | - -- Always check for `[AGENT_BOOSTER_AVAILABLE]` or `[TASK_MODEL_RECOMMENDATION]` before spawning agents -- Use Edit tool directly when `[AGENT_BOOSTER_AVAILABLE]` - -## Swarm Configuration & Anti-Drift - -- ALWAYS use hierarchical topology for coding swarms -- Keep maxAgents at 6-8 for tight coordination -- Use specialized strategy for clear role boundaries -- Use `raft` consensus for hive-mind (leader maintains authoritative state) -- Run frequent checkpoints via `post-task` hooks -- Keep shared memory namespace for all agents - -```bash -npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized -``` - -## Swarm Execution Rules - -- ALWAYS use `run_in_background: true` for all agent Task calls -- ALWAYS put ALL agent Task calls in ONE message for parallel execution -- After spawning, STOP — do NOT add more tool calls or check status -- Never poll TaskOutput or check swarm status — trust agents to return -- When agent results arrive, review ALL results before proceeding - -## V3 CLI Commands - -### Core Commands - -| Command | Subcommands | Description | -| --------- | ------------- | ------------- | -| `init` | 4 | Project initialization | -| `agent` | 8 | Agent lifecycle management | -| `swarm` | 6 | Multi-agent swarm coordination | -| `memory` | 11 | AgentDB memory with HNSW search | -| `task` | 6 | Task creation and lifecycle | -| `session` | 7 | Session state management | -| `hooks` | 17 | Self-learning hooks + 12 workers | -| `hive-mind` | 6 | Byzantine fault-tolerant consensus | - -### Quick CLI Examples - -```bash -npx @claude-flow/cli@latest init --wizard -npx @claude-flow/cli@latest agent spawn -t coder --name my-coder -npx @claude-flow/cli@latest swarm init --v3-mode -npx @claude-flow/cli@latest memory search --query "authentication patterns" -npx @claude-flow/cli@latest doctor --fix -``` - -## Available Agents (60+ Types) - -### Core Development - -`coder`, `reviewer`, `tester`, `planner`, `researcher` - -### Specialized - -`security-architect`, `security-auditor`, `memory-specialist`, `performance-engineer` - -### Swarm Coordination - -`hierarchical-coordinator`, `mesh-coordinator`, `adaptive-coordinator` - -### GitHub & Repository - -`pr-manager`, `code-review-swarm`, `issue-tracker`, `release-manager` - -### SPARC Methodology - -`sparc-coord`, `sparc-coder`, `specification`, `pseudocode`, `architecture` - -## Memory Commands Reference - -```bash -# Store (REQUIRED: --key, --value; OPTIONAL: --namespace, --ttl, --tags) -npx @claude-flow/cli@latest memory store --key "pattern-auth" --value "JWT with refresh" --namespace patterns - -# Search (REQUIRED: --query; OPTIONAL: --namespace, --limit, --threshold) -npx @claude-flow/cli@latest memory search --query "authentication patterns" - -# List (OPTIONAL: --namespace, --limit) -npx @claude-flow/cli@latest memory list --namespace patterns --limit 10 - -# Retrieve (REQUIRED: --key; OPTIONAL: --namespace) -npx @claude-flow/cli@latest memory retrieve --key "pattern-auth" --namespace patterns -``` - -## Quick Setup - -```bash -claude mcp add claude-flow -- npx -y @claude-flow/cli@latest -npx @claude-flow/cli@latest daemon start -npx @claude-flow/cli@latest doctor --fix -``` - -## Claude Code vs CLI Tools - -- Claude Code's Task tool handles ALL execution: agents, file ops, code generation, git -- CLI tools handle coordination via Bash: swarm init, memory, hooks, routing -- NEVER use CLI tools as a substitute for Task tool agents ## Multi-Agent Communication @@ -360,28 +225,3 @@ Key rules: - Lock `git-commit` and `git-push` resources for the duration of those operations Directory structure: `~/.claude/agent-comms/{messages,locks,status}` - -## Knowledge graph (graphify) - -**This project uses the graphify knowledge graph at `graphify-out/` — always consult it for architecture/codebase questions, and (re)build it when missing or stale.** - -Rules, in priority order: - -1. **Before answering architecture or codebase questions**: read `graphify-out/GRAPH_REPORT.md` for god nodes + community structure, and `graphify-out/wiki/index.md` for a navigable summary. The graph often surfaces helpers/utilities that grep misses because names don't overlap. -2. **If `graphify-out/` is missing**: build it FIRST before doing any non-trivial exploration. Command (from the repo root): - - ```bash - "${GRAPHIFY_PYTHON:-python3}" \ - -c "from graphify.watch import _rebuild_code; from pathlib import Path; _rebuild_code(Path('.'))" - ``` - - Set `GRAPHIFY_PYTHON` to your graphify venv's Python interpreter (`/.venv/bin/python3`); falls back to `python3` if the package is installed system-wide. Runs for ~1–3 minutes on this repo; run it in the background (`run_in_background: true`) so you can start reading other things while it finishes. -3. **After modifying code files in a session**: re-run the same command to keep the graph current. The installed `PreToolUse` hook in `.claude/settings.json` handles this automatically for Write/Edit/MultiEdit, but the hook has a 5-second timeout — on a large edit batch the rebuild may be skipped; run the command manually in that case. -4. **Never edit code you haven't mapped** when the graph is available. Prefer graph-assisted navigation over raw grep for cross-cutting questions ("who calls X", "where is Y implemented", "what would break if I rename Z"). - -If `graphify` is not on PATH, locate your local install (typically `~/bin/graphify` or your venv's `bin/`). The `graphify claude install` subcommand re-registers the PreToolUse hook if it's been removed. - -## Support - -- Documentation: -- Issues: From 45060ab3df58e78cc728e19aa7a894471f231170 Mon Sep 17 00:00:00 2001 From: Cristian Magherusan-Stanciu Date: Mon, 28 Sep 2026 18:54:01 +0200 Subject: [PATCH 2/2] docs(claude-md): module is rooted at the repo root --- CLAUDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 25c9d96b6..ef1c69e4d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -41,7 +41,7 @@ ## Build & Test -The whole repo is a single Go module rooted at `cmd/`. +The whole repo is a single Go module rooted at the repository root; the main package lives in `cmd/`. ```bash # Build