Rule
Cross-plugin orthogonality: plugins never reference each other by name — orchestrators included. A skill discovers a cross-plugin capability at runtime by description matching, never a hardcoded aidd-<plugin>:… address. It is not yet mechanically enforced, so violations slip through.
Violation
aidd-orchestrator/skills/00-async-dev hardcodes aidd-dev:
Should delegate by capability:
SKILL.md:29 + references/routing.md:36-37 — trigger regexes match /aidd-dev:02-implement, /aidd-dev:05-review.
SKILL.md:81 — check-sdlc verifies aidd-dev:00-sdlc (should be "an SDLC-capable orchestrator").
README.md:17 — pointer "use aidd-dev:00-sdlc".
Deployment-level (names the package to install it — harder to make capability-based):
SKILL.md:62, actions/setup/07-install-user-scope-plugins.md, assets/setup/workflow-template.yml:165,260 — setup installs aidd-dev@aidd-framework.
Fix options
- Capability-based for triggers +
check-sdlc + README; leave setup/install naming the package.
- Full: make setup capability-driven too (needs design).
- Add a lefthook grep for cross-plugin literals so this can't regress.
Found during the docs rework while verifying ARCHITECTURE.md against the code.
Acceptance criteria
Related
Rule
Cross-plugin orthogonality: plugins never reference each other by name — orchestrators included. A skill discovers a cross-plugin capability at runtime by description matching, never a hardcoded
aidd-<plugin>:…address. It is not yet mechanically enforced, so violations slip through.Violation
aidd-orchestrator/skills/00-async-devhardcodesaidd-dev:Should delegate by capability:
SKILL.md:29+references/routing.md:36-37— trigger regexes match/aidd-dev:02-implement,/aidd-dev:05-review.SKILL.md:81—check-sdlcverifiesaidd-dev:00-sdlc(should be "an SDLC-capable orchestrator").README.md:17— pointer "useaidd-dev:00-sdlc".Deployment-level (names the package to install it — harder to make capability-based):
SKILL.md:62,actions/setup/07-install-user-scope-plugins.md,assets/setup/workflow-template.yml:165,260— setup installsaidd-dev@aidd-framework.Fix options
check-sdlc+ README; leave setup/install naming the package.Found during the docs rework while verifying
ARCHITECTURE.mdagainst the code.Acceptance criteria
plugins/aidd-orchestrator/names another plugin by address.aidd-dev.aidd-devdegrades the flow with a clear message instead of failing on a missing address.Related