Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity
Files
4aab9d327c4457bed53b24144483473aacd068da
holocron/plugins/kyberforge/skills/forge/references/sources.md
Defame1297 4aab9d327c refactor(kyberforge): retrofit forge to the ADR-0020 contract 
Description 648 -> 387 chars, body 1093 -> 541 words. This was the last
body FAIL in the 39-skill corpus.

The body was not trimmed to fit. forge routes four artifact types that a
single invocation classifies between, so the contract requires a dispatch
table plus the gates common to every route, with each route self-contained
in references/. Adds references/author-routes.md (skill and agent),
references/apm-routes.md (plugin and marketplace entry) and
references/version-bump.md. Skill and agent share one file: they differ on
one axis only, which audit skill verifies the result.

Fixes three defects the first pass introduced or relocated:

- references/apm-routes.md claimed `apm audit` "already runs inside
  apm-workflow's own flow" and told the agent to confirm it ran clean.
  apm-workflow dispatches audit as its own row; the configure and
  marketplace rows never reach it. That was the only completion check
  these routes had, and it could never be satisfied. Replaced with a
  manual read-back the agent performs itself.
- "Read only the reference file" forbade the multi-artifact case the same
  body documents two lines later, and ADR-0011 records eight artifacts
  authored in one pass.
- The announce gate became a closing gate, reachable only after the
  invocation it was meant to precede. Moved to the end of Step 2.

Also restores the artifact enumeration to the plugin row, normalises to
bare unnamespaced skill names per AGENTS.md, adds a dispatch fallback for
artifacts matching no row, and corrects three provenance entries -- one
asserted a contribution that did not happen.

Refs #99

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MWb5RQgCL1ye7cGp2RPb2u
2026-08-30 16:31:23 +00:00

5.5 KiB
Raw Blame History

Sources

claude-code-subagents-docs

  • URL: https://code.claude.com/docs/en/sub-agents
  • Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
  • Description: Official Claude Code subagent reference — definition format, all frontmatter fields, scope priority, built-in agents, CLI flags, environment variables, known limitations. Grounds the fork-vs-inline invocation logic in references/author-routes.md, the always-inline decision for the apm routes in references/apm-routes.md, and the clean-context bump subagent in references/version-bump.md: fork inherits full conversation history via /fork or subagent_type: "fork", is not a declarable frontmatter field on any agent definition, cannot be nested (a fork cannot spawn another fork), and is a caller-side invocation choice rather than a property of the artifact being routed to.
  • Contributing files: SKILL.md, references/author-routes.md, references/apm-routes.md, references/version-bump.md
  • Status: extracted

context7-websites-code-claude

  • URL: context7:/websites/code_claude
  • Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
  • Description: Official Claude Code documentation site indexed by Context7 — confirms the context: fork skill-level frontmatter field means isolated/fresh execution, the opposite of what the /fork subagent command does (inherits conversation). Informs the Gotchas entry in SKILL.md warning against conflating the two; nothing else in this skill draws on it, and no references/ file mentions the context: fork field.
  • Contributing files: SKILL.md
  • Status: extracted

claude-code-plugins-docs

  • URL: https://code.claude.com/docs/en/plugins
  • Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
  • Description: Official Claude Code plugin authoring guide — plugin structure, manifest fields, loading methods, skill namespacing, agent activation, marketplace submission. Background context for Step 2's plugin/marketplace rows; no forge-specific content drawn directly from it beyond that.
  • Contributing files: (none)
  • Status: extracted

agentskills-spec

  • URL: https://agentskills.io/specification.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Complete SKILL.md format specification — confirms assets/, references/, and scripts/ are warranted only by the bulk/reusability of supporting content (large reference material, executable code, templates), not by a skill's category, and forge's per-route procedures are that kind of supporting content — so the spec permits the references/ split here but does not require it. The warrant is a house decision: ADR-0020's rule that dispatch is mandatory at two or more mutually exclusive flows, which forge's four-row table is. references/sources.md likewise exists for this repo's own provenance-chain convention (see CONTEXT.md), not because the spec requires it.
  • Contributing files: SKILL.md
  • Status: extracted

agentskills-home

  • URL: https://agentskills.io/home.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Agent Skills overview — not drawn on directly for forge; listed for provenance completeness against the agentskillsio research doc.
  • Contributing files: (none)
  • Status: extracted

agentskills-best-practices

  • URL: https://agentskills.io/skill-creation/best-practices.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Best practices for skill creators — not drawn on directly for forge; listed for provenance completeness against the agentskillsio research doc.
  • Contributing files: (none)
  • Status: extracted

agentskills-optimizing-descriptions

  • URL: https://agentskills.io/skill-creation/optimizing-descriptions.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: How to test and improve skill descriptions for triggering accuracy — not drawn on directly for forge; listed for provenance completeness against the agentskillsio research doc.
  • Contributing files: (none)
  • Status: extracted

agentskills-evaluating-skills

  • URL: https://agentskills.io/skill-creation/evaluating-skills.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Eval-driven skill quality improvement — not drawn on directly for forge; listed for provenance completeness against the agentskillsio research doc.
  • Contributing files: (none)
  • Status: extracted

agentskills-using-scripts

  • URL: https://agentskills.io/skill-creation/using-scripts.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Using scripts in skills — not applicable to forge (no scripts/ directory); listed for provenance completeness against the agentskillsio research doc.
  • Contributing files: (none)
  • Status: extracted

agentskills-quickstart

  • URL: https://agentskills.io/skill-creation/quickstart.md
  • Research doc: plugins/kyberforge/docs/research/docs/agentskillsio/sources.md
  • Description: Step-by-step first-skill walkthrough — not drawn on directly for forge; listed for provenance completeness against the agentskillsio research doc.
  • Contributing files: (none)
  • Status: extracted
Reference in New Issue View Git Blame Copy Permalink