Skip to content

chore(agentic): adopt canonical agentic structure#1084

Draft
BeArchiTek wants to merge 2 commits into
stablefrom
chore/agentic-structure
Draft

chore(agentic): adopt canonical agentic structure#1084
BeArchiTek wants to merge 2 commits into
stablefrom
chore/agentic-structure

Conversation

@BeArchiTek

@BeArchiTek BeArchiTek commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Brings the SDK in line with the canonical OpsMill agentic structure (per the opsmill-agentic-structure audit).

Mechanical changes in this PR

  • .agents/: added the .agents/skills/ source-of-truth home; migrated dev/commands/.agents/commands/ (git mv, 11 command files).
  • .claude/commands: re-pointed the symlink from ../dev/commands to ../.agents/commands (it was pointing at the wrong source — an error).
  • dev/: scaffolded the missing dev/adr|guides|guidelines|knowledge/ with README stubs.
  • AGENTS.md: updated dev/commands path references to .agents/commands.

Left for a human (judgement)

  • .specify/memory/constitution.md is still the unedited spec-kit template (placeholder tokens). Author the project's standing principles.
  • No speckit_version pin recorded in .specify/init-options.json — add one.
  • Author skills under .agents/skills/.

CLAUDE.md already imports @AGENTS.md correctly — unchanged.

Draft — structural changes only; no content authored.

🤖 Generated with Claude Code


Summary by cubic

Adopts the canonical OpsMill agentic structure and tightens AGENTS.md to the lean-router standard. Moves commands to .agents/commands, adds .agents/skills/, fixes the .claude/commands symlink, and scaffolds dev docs.

  • Refactors

    • Move dev/commands.agents/commands (11 files; no content changes).
    • Add .agents/skills/ (source of truth; .gitkeep placeholder).
    • Tighten AGENTS.md (update command paths, fold “Why the SDK” into Product context, remove stale Knowledge base, use uv run invoke lint-docs).
    • Scaffold dev/adr/, dev/guides/, dev/guidelines/, dev/knowledge/ with README stubs.
  • Bug Fixes

    • Point .claude/commands symlink to ../.agents/commands.

Written for commit 440abf7. Summary will update on new commits.

Review in cubic

Add .agents/skills source-of-truth home; migrate dev/commands -> .agents/commands; re-point .claude/commands symlink to ../.agents/commands (was wrong-source ../dev/commands); scaffold dev/adr|guides|guidelines|knowledge; update AGENTS.md command paths. Audited by opsmill-agentic-structure.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 16, 2026

Copy link
Copy Markdown

Deploying infrahub-sdk-python with  Cloudflare Pages  Cloudflare Pages

Latest commit: 440abf7
Status: ✅  Deploy successful!
Preview URL: https://c275cc11.infrahub-sdk-python.pages.dev
Branch Preview URL: https://chore-agentic-structure.infrahub-sdk-python.pages.dev

View logs

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 8 files

Re-trigger cubic

Remove the stale Knowledge base section pointing to a non-existent dev/knowledge/ directory and three missing files; fold the redundant 'Why the SDK' paragraph into the Product context lead; replace the vague 'Run markdownlint' boundary with the actual uv run invoke lint-docs command. Every repo-specific fact, command, path, and version is preserved; 104 -> 91 lines.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant