Follow-up to #1084 (agentic-structure adoption, @BeArchiTek).
An agentic-structure audit of the PR branch confirms the .agents/ source of truth, the .claude/skills + .claude/commands adapter views, and the dev/ reference layout are now canonical. (The .claude/skills view was just re-pointed from the removed ../dev/skills to ../.agents/skills in commit 470a935.)
Two items remain before the repo is fully aligned. Both need a human decision, so they're tracked here rather than auto-fixed.
1. .claude/rules adapter view is wrong-source and dangling (error)
.claude/rules is a committed symlink pointing at ../dev/rules, which no longer exists — and .agents/rules/ doesn't exist either, so the view dangles. Decide:
- If this repo uses Claude behavioural rules: create
.agents/rules/ (authored once, vendor-neutral) and re-point — ln -sfn ../.agents/rules .claude/rules. (mechanical once decided)
- If it doesn't: delete the orphan view —
git rm .claude/rules. (mechanical)
The skills and commands views already use the correct ../.agents/* source; whichever path is chosen should match that convention.
2. Constitution is still the spec-kit template stub (warning)
.specify/memory/constitution.md (→ dev/constitution.md) is the unedited spec-kit template — it still contains [PROJECT_NAME], [PRINCIPLE_*], and <!-- Example placeholder markers. Author the SDK's standing engineering principles to replace it. The other OpsMill repos (infrahub, infrahub-mcp, styrmin) already have real authored constitutions. (judgement)
The fleet-wide adapter distribution model (committed symlinks vs gitignored + regenerator) is being standardized separately in an opsmill/opsmill-skills tracking issue.
🤖 Produced from an opsmill-agentic-structure audit · Generated with Claude Code
Follow-up to #1084 (agentic-structure adoption, @BeArchiTek).
An agentic-structure audit of the PR branch confirms the
.agents/source of truth, the.claude/skills+.claude/commandsadapter views, and thedev/reference layout are now canonical. (The.claude/skillsview was just re-pointed from the removed../dev/skillsto../.agents/skillsin commit470a935.)Two items remain before the repo is fully aligned. Both need a human decision, so they're tracked here rather than auto-fixed.
1.
.claude/rulesadapter view is wrong-source and dangling (error).claude/rulesis a committed symlink pointing at../dev/rules, which no longer exists — and.agents/rules/doesn't exist either, so the view dangles. Decide:.agents/rules/(authored once, vendor-neutral) and re-point —ln -sfn ../.agents/rules .claude/rules. (mechanical once decided)git rm .claude/rules. (mechanical)The
skillsandcommandsviews already use the correct../.agents/*source; whichever path is chosen should match that convention.2. Constitution is still the spec-kit template stub (warning)
.specify/memory/constitution.md(→dev/constitution.md) is the unedited spec-kit template — it still contains[PROJECT_NAME],[PRINCIPLE_*], and<!-- Exampleplaceholder markers. Author the SDK's standing engineering principles to replace it. The other OpsMill repos (infrahub, infrahub-mcp, styrmin) already have real authored constitutions. (judgement)The fleet-wide adapter distribution model (committed symlinks vs gitignored + regenerator) is being standardized separately in an opsmill/opsmill-skills tracking issue.
🤖 Produced from an
opsmill-agentic-structureaudit · Generated with Claude Code