Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

feat(ruflo-ddd): v0.2.0 β€” adopt plugin contract (ADR-0001, namespace coordination, smoke as contract)

Reuvenab5ec6b8825d
diff --git a/plugins/ruflo-ddd/.claude-plugin/plugin.json b/plugins/ruflo-ddd/.claude-plugin/plugin.json
index 954623aadd..02a2a32ad1 100644
--- a/plugins/ruflo-ddd/.claude-plugin/plugin.json
+++ b/plugins/ruflo-ddd/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-ddd",
- "description": "Domain-Driven Design scaffolding \u2014 bounded contexts, aggregate roots, domain events, and anti-corruption layers",
- "version": "0.1.1",
+ "description": "Domain-Driven Design scaffolding β€” bounded contexts, aggregate roots, domain events, value objects, repositories, and anti-corruption layers; navigable domain graph stored in AgentDB",
+ "version": "0.2.0",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
@@ -14,6 +14,10 @@
"domain-driven-design",
"bounded-context",
"aggregate",
- "events"
+ "events",
+ "acl",
+ "value-objects",
+ "repositories",
+ "mcp"
]
}
diff --git a/plugins/ruflo-ddd/README.md b/plugins/ruflo-ddd/README.md
index dc168f5a33..634007ab30 100644
--- a/plugins/ruflo-ddd/README.md
+++ b/plugins/ruflo-ddd/README.md
@@ -61,8 +61,31 @@ src/<context-name>/
Detected via import analysis: upstream/downstream, ACL, shared kernel, published language. Boundary violations (direct cross-context imports) are flagged by `ddd validate`.
+## Compatibility
+
+- **CLI:** pinned to `@claude-flow/cli` v3.6 major+minor.
+- **Verification:** `bash plugins/ruflo-ddd/scripts/smoke.sh` is the contract.
+
+## Namespace coordination
+
+This plugin owns the `ddd-patterns` AgentDB namespace (kebab-case, follows the convention from [ruflo-agentdb ADR-0001 Β§"Namespace convention"](../ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md)). Reserved namespaces (`pattern`, `claude-memories`, `default`) MUST NOT be shadowed.
+
+`ddd-patterns` stores reusable bounded-context shapes, aggregate templates, and event vocabularies for cross-project reuse. Accessed via `memory_*` tools (namespace-routed).
+
+## Verification
+
+```bash
+bash plugins/ruflo-ddd/scripts/smoke.sh
+# Expected: "10 passed, 0 failed"
+```
+
+## Architecture Decisions
+
+- [`ADR-0001` β€” ruflo-ddd plugin contract](./docs/adrs/0001-ddd-contract.md)
+
## Related Plugins
+- `ruflo-agentdb` β€” namespace convention owner; backing store for the domain graph
- `ruflo-adr` -- Document domain decisions as Architecture Decision Records
- `ruflo-sparc` -- Architecture phase leverages DDD bounded context patterns
- `ruflo-migrations` -- Align migration boundaries with aggregate roots
diff --git a/plugins/ruflo-ddd/docs/adrs/0001-ddd-contract.md b/plugins/ruflo-ddd/docs/adrs/0001-ddd-contract.md
new file mode 100644
index 0000000000..71e4672b5b
--- /dev/null
+++ b/plugins/ruflo-ddd/docs/adrs/0001-ddd-contract.md
@@ -0,0 +1,48 @@
+---
+id: ADR-0001
+title: ruflo-ddd plugin contract β€” pinning, namespace coordination, ADR cross-link, smoke as contract
+status: Proposed
+date: 2026-05-04
+authors:
+ - reviewer (Claude Code)
+tags: [plugin, ddd, bounded-context, aggregate, namespace, smoke-test]
+---
+
+## Context
+
+`ruflo-ddd` (v0.1.1) is a code-scaffolding plugin (no MCP tools of its own). Surface:
+
+- 1 agent (`domain-modeler`)
+- 3 skills (`ddd-context`, `ddd-aggregate`, `ddd-validate`)
+- 1 command (`/ddd`) with 6 subcommands (`context create|list`, `aggregate`, `event`, `validate`, `map`)
+- `REFERENCE.md` (token-optimized per ADR-098 Part 2)
+
+Stores the domain model as a navigable graph in AgentDB with hierarchical nodes + causal edges for context dependencies. Pairs naturally with `ruflo-adr` (domain decisions) and `ruflo-sparc` (Architecture phase).
+
+Same gaps as the others: no plugin-level ADR, no smoke test, no Compatibility section, no namespace coordination cross-reference, version `0.1.1`.
+
+## Decision
+
+1. Add this ADR (Proposed).
+2. README augment: Compatibility (pin v3.6), Namespace coordination (claims `ddd-patterns`; defers to ruflo-agentdb ADR-0001), Verification + Architecture Decisions sections.
+3. Bump `0.1.1 β†’ 0.2.0`. Keywords add `acl`, `value-objects`, `repositories`, `mcp`.
+4. `scripts/smoke.sh` β€” 10 structural checks: version + keywords; all 3 skills + 1 agent + 1 command present with valid frontmatter; 6 subcommands documented; REFERENCE.md non-empty; v3.6 pin; namespace coordination; ADR Proposed; ddd-patterns namespace claimed; no wildcard tools.
+
+## Consequences
+
+**Positive:** plugin joins the cadence. Reference data centralization (REFERENCE.md) follows the ADR-098 Part 2 token-diet pattern.
+
+**Negative:** none β€” plugin behavior unchanged.
+
+## Verification
+
+```bash
+bash plugins/ruflo-ddd/scripts/smoke.sh
+# Expected: "10 passed, 0 failed"
+```
+
+## Related
+
+- `plugins/ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md` β€” namespace convention
+- `plugins/ruflo-adr/docs/adrs/0001-adr-plugin-pattern.md` β€” REFERENCE.md token-diet precedent
+- `plugins/ruflo-ruvector/docs/adrs/0001-pin-ruvector-0.2.25.md`
diff --git a/plugins/ruflo-ddd/scripts/smoke.sh b/plugins/ruflo-ddd/scripts/smoke.sh
new file mode 100755
index 0000000000..5b2c7f6d7d
--- /dev/null
+++ b/plugins/ruflo-ddd/scripts/smoke.sh
@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+set -u
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PASS=0
+FAIL=0
+step() { printf "β†’ %s ... " "$1"; }
+ok() { printf "PASS\n"; PASS=$((PASS+1)); }
+bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }
+
+step "1. plugin.json declares 0.2.0 with new keywords"
+v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
+if [[ "$v" != "0.2.0" ]]; then bad "expected 0.2.0, got '$v'"; else
+ miss=""
+ for k in acl value-objects repositories mcp; do
+ grep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"
+ done
+ [[ -z "$miss" ]] && ok || bad "missing keywords:$miss"
+fi
+
+step "2. all 3 skills present with valid frontmatter"
+miss=""
+for s in ddd-context ddd-aggregate ddd-validate; do
+ f="$ROOT/skills/$s/SKILL.md"
+ [[ -f "$f" ]] || { miss="$miss missing-$s"; continue; }
+ for k in 'name:' 'description:' 'allowed-tools:'; do
+ grep -q "^$k" "$f" || miss="$miss $s-no-$k"
+ done
+done
+[[ -z "$miss" ]] && ok || bad "$miss"
+
+step "3. agent + command present"
+[[ -f "$ROOT/agents/domain-modeler.md" ]] && [[ -f "$ROOT/commands/ddd.md" ]] \
+ && ok || bad "agent or command file missing"
+
+step "4. /ddd command covers 6 subcommands"
+F="$ROOT/commands/ddd.md"
+miss=""
+for sub in 'context' 'aggregate' 'event' 'validate' 'map' 'list'; do
+ grep -q "$sub" "$F" || miss="$miss $sub"
+done
+[[ -z "$miss" ]] && ok || bad "missing subcommands:$miss"
+
+step "5. REFERENCE.md exists and is non-empty"
+[[ -s "$ROOT/REFERENCE.md" ]] && ok || bad "REFERENCE.md missing or empty"
+
+step "6. README pins @claude-flow/cli to v3.6"
+grep -qE "@claude-flow/cli.*v3\.6|v3\.6.*claude-flow/cli" "$ROOT/README.md" \
+ && ok || bad "v3.6 pin missing"
+
+step "7. README defers to ruflo-agentdb namespace convention"
+grep -q "ruflo-agentdb" "$ROOT/README.md" \
+ && grep -q "Namespace convention" "$ROOT/README.md" \
+ && ok || bad "namespace coordination block incomplete"
+
+step "8. ddd-patterns namespace claimed"
+grep -q "ddd-patterns" "$ROOT/README.md" \
+ && ok || bad "ddd-patterns not claimed in README"
+
+step "9. ADR-0001 exists with status Proposed"
+ADR="$ROOT/docs/adrs/0001-ddd-contract.md"
+[[ -f "$ADR" ]] && grep -qE "^status:[[:space:]]*Proposed" "$ADR" \
+ && ok || bad "ADR missing or status != Proposed"
+
+step "10. no wildcard tool grants in skills"
+bad_skills=""
+for f in "$ROOT"/skills/*/SKILL.md; do
+ grep -q '^allowed-tools:[[:space:]]*\*' "$f" && bad_skills="$bad_skills $(basename $(dirname "$f"))"
+done
+[[ -z "$bad_skills" ]] && ok || bad "wildcard:$bad_skills"
+
+printf "\n%s passed, %s failed\n" "$PASS" "$FAIL"
+[[ $FAIL -eq 0 ]] || exit 1