Skip to content

feat(aidd-context): per-artifact context generators (skill, rule, agent, command, hook)#264

Merged
blafourcade merged 3 commits into
mainfrom
feat/aidd-context-generators
Jun 15, 2026
Merged

feat(aidd-context): per-artifact context generators (skill, rule, agent, command, hook)#264
blafourcade merged 3 commits into
mainfrom
feat/aidd-context-generators

Conversation

@blafourcade

Copy link
Copy Markdown
Contributor

What

Splits the 03-context-generate monolith into five dedicated, router-based generators:

  • 07-skill-generate, 08-rule-generate, 09-agent-generate, 10-command-generate, 11-hook-generate

Each follows the same contract: a tool-agnostic SKILL.md + actions, with all per-tool data (paths, frontmatter, events, scopes) isolated in references/.

Why

The monolith was verbose and over-coupled (one action per case, tool-specifics leaking into agnostic files). These are leaner, self-conforming to the R1-R11 skill-authoring contract, and easier to maintain per artifact.

Highlights

  • Tool-agnostic SKILL.md + actions; references hold the per-tool slice.
  • Host-project and plugin-source write modes; skill-generate also supports modify mode.
  • Unsupported tools are skipped with an actionable reason.
  • Hooks researched across all five tools and corrected against the installed CLIs (notably: Codex hooks are stable/default-on, not flag-gated).
  • Detection verified end-to-end against the real CLIs for Claude, Copilot, OpenCode, and Codex (marker-artifact loaded at the path each reference claims).

Not in this PR (follow-ups)

  • publish skill (package a user's artifacts into a distributable plugin + marketplace entry), which replaces the monolith's plugin/marketplace types.
  • Retiring/redirecting 03-context-generate.
  • Legacy R1-R11 migration of older skills/commands.
  • Cursor detection re-check (no headless API key available during verification).

🤖 Generated with Claude Code

@blafourcade blafourcade requested a review from a team as a code owner June 15, 2026 03:35
@alexsoyes

Copy link
Copy Markdown
Contributor

@blafourcade All good on simplifera après :)

@jdm-web jdm-web 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.

Très cool comme refacto!

blafourcade and others added 3 commits June 15, 2026 09:31
Split the 03-context-generate monolith into five dedicated router-based
skills: 07-skill, 08-rule, 09-agent, 10-command, 11-hook.

- SKILL.md and actions stay tool-agnostic; per-tool data (paths, frontmatter,
  events, scopes) lives only in references.
- Host-project and plugin-source write modes, plus modify mode for skills.
- Unsupported tools are skipped with an actionable reason.
- Hook support researched across all five tools and corrected to match the
  installed CLIs (Codex hooks are stable/default-on, not flag-gated).
- Detection verified end-to-end against the real CLIs for Claude, Copilot,
  OpenCode, and Codex.
- Registered in plugin.json; CATALOG and README counts regenerated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
A plugin or standalone hooks/hooks.json wraps the event map under a top-level
`hooks` key, the same as settings.json. The reference wrongly stated the file
is the bare hooks object, which `claude plugin validate` rejects (verified: the
wrapped form passes, the bare form fails). Inherited from the monolith.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…enerators

Reduce 03-context-generate from a seven-artifact monolith to a thin router
that hands off to the dedicated generators, and renumber the generators to
04-08 so they sit directly after the router (mermaid, learn, discovery move
to 09-11).

- Drop plugin and marketplace generation (parked); update descriptions and docs.
- Update every cross-reference, the plugin.json order, and the catalog.
- Each SKILL name now matches its folder; all aidd-context:NN refs resolve.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@blafourcade blafourcade force-pushed the feat/aidd-context-generators branch from d6f185b to 23e373a Compare June 15, 2026 07:31
@blafourcade blafourcade requested review from alexsoyes and jdm-web June 15, 2026 07:37
@blafourcade blafourcade assigned alexsoyes and unassigned blafourcade Jun 15, 2026
@blafourcade blafourcade merged commit 647fe5a into main Jun 15, 2026
9 checks passed
@aidd-bot aidd-bot Bot mentioned this pull request Jun 15, 2026
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.

3 participants