docs(kyberforge): narrow issue #89 scope, migrate CC platform facts to apm-workflow
A grill-me session determined plugin-author/marketplace-author are fully superseded by the landed apm-install/apm-workflow/apm-orchestrate artifacts and will be deleted (not adapted) under issue #90, narrowing issue #89 to skill-author/agent-author only; forge stays untouched. ADR-0015 is amended to record this correction plus a three-way content-migration audit. Claude Code platform-constraint facts that lived only in plugin-author/marketplace-author (reserved name prefixes, the ADR-0010 agents/ stray-.md validator gotcha, claude plugin validate as a terminal check, and a removal/re-pack confirm-before-proceeding note) remain true post-conversion and are migrated into apm-workflow's reference docs via kyberforge:skill-author, which also updated the skill's README and sources.md provenance records. Dual-manifest-specific conventions (ADR-0006 parity, CC/Copilot field-placement split) do not carry forward since they no longer apply. ADR: 0015
This commit is contained in:
@@ -38,9 +38,18 @@ new hand-maintained manifest format.
|
||||
- New operational tooling — `apm-install` (skill), `apm-workflow` (skill), `apm-orchestrate`
|
||||
(agent) — lands in `kyberforge`, tracked in issue #88
|
||||
(https://git.dev.rkdr.net/Defame1297/holocron/issues/88).
|
||||
- Adapting `plugin-author`/`marketplace-author`/`skill-author`/`agent-author`/`forge`'s routing to
|
||||
author `.apm/`-native content is deferred to issue #89
|
||||
(https://git.dev.rkdr.net/Defame1297/holocron/issues/89).
|
||||
- Adapting `skill-author`/`agent-author`'s routing to author `.apm/`-native content (retargeting to
|
||||
`.apm/skills/`, `.apm/agents/` paths — the content these two skills author is still meaningful
|
||||
post-conversion) is deferred to issue #89
|
||||
(https://git.dev.rkdr.net/Defame1297/holocron/issues/89). `forge` is out of scope for #89 — it
|
||||
stays untouched by this whole conversion effort and keeps routing to whatever the live author
|
||||
skills are at the time.
|
||||
- **`plugin-author`/`marketplace-author` are not adapted — they are superseded and deleted.**
|
||||
Unlike `skill-author`/`agent-author`, nothing in these two skills carries forward as authoring
|
||||
routing: `apm compile`/`apm pack` will generate `.claude-plugin/marketplace.json` and
|
||||
per-provider `plugin.json` directly from `apm.yml` + `.apm/`, so `apm-install`/`apm-workflow`/
|
||||
`apm-orchestrate` (issue #88, already landed on this branch) fully replace what these two skills
|
||||
did. Deleting `plugin-author`/`marketplace-author` is part of issue #90's execution, not #89's.
|
||||
- Actually translating the existing plugins into `apm.yml` + `.apm/` and running the real
|
||||
conversion is deferred to issue #90
|
||||
(https://git.dev.rkdr.net/Defame1297/holocron/issues/90).
|
||||
@@ -66,11 +75,33 @@ plugin for a single consumer isn't worth it yet. Accepted as an explicit tradeof
|
||||
as ADR-0011's `gitea-workflow` naming tradeoff) — worth revisiting if this tooling is ever reused
|
||||
outside holocron's own conversion.
|
||||
|
||||
## Content migration out of `plugin-author`/`marketplace-author`
|
||||
|
||||
A content audit of `plugin-author`/`marketplace-author` (same `grill-with-docs` session as this
|
||||
correction) sorted what they document into three buckets:
|
||||
|
||||
- **Claude Code platform constraints — carried forward.** Facts that stay true regardless of
|
||||
authoring model (reserved plugin-name prefixes; the `agents/`-directory stray-`.md`-file
|
||||
validator gotcha, ADR-0010; `claude plugin validate` as a required terminal check) have been
|
||||
added into `apm-workflow`'s reference docs, since compiled output still has to satisfy these
|
||||
constraints post-conversion.
|
||||
- **Dual-manifest artifacts — obsolete, not carried forward.** Conventions that existed only
|
||||
because of hand-authored dual manifests (ADR-0006's version-parity/patch-bump rule, the
|
||||
CC-vs-Copilot field-placement split, dual-file mirroring) are obsolete under `apm.yml`'s
|
||||
single-manifest model and were deliberately dropped.
|
||||
- **Holocron policy choice — flagged for #90, not resolved here.** `marketplace-author`'s
|
||||
catalog-version convention (minor bump for package add/remove, patch bump for field-only
|
||||
updates) isn't an APM mechanic — `apm` doesn't enforce it — but it's still a meaningful holocron
|
||||
policy worth re-applying to `apm.yml`'s `marketplace.packages[].version` field once #90 wires up
|
||||
real marketplace authoring. Where/how that gets implemented is #90's decision, not this ADR's.
|
||||
|
||||
## Consequences
|
||||
|
||||
- ADR-0001 is superseded once issue #90 executes.
|
||||
- ADR-0006 (plugin-version-parity) will need a third file, `apm.yml`, folded into its parity
|
||||
check once #90 lands — not resolved by this ADR.
|
||||
- ADR-0006 (plugin-version-parity) becomes moot once #90 lands: `plugin.json`/`marketplace.json`
|
||||
become compiled output of a single `apm.yml`, so there's no second hand-authored file left to
|
||||
keep in parity, and `plugin-author` — the skill that enforced ADR-0006 — is deleted rather than
|
||||
adapted (see "Content migration" above). Not resolved by this ADR.
|
||||
- ADR-0010 (agent sources relocated outside agents dir) needs revisiting once agents move to
|
||||
`plugins/<name>/.apm/agents/` — the directory path changes, not the pre-existing `.agent.md`
|
||||
extension convention (ADR-0005/ADR-0010, unaffected) — not resolved by this ADR.
|
||||
@@ -79,5 +110,6 @@ outside holocron's own conversion.
|
||||
move under `.apm/` — not resolved by this ADR.
|
||||
- `kyberforge` gains three new artifacts (issue #88) before any conversion of existing content
|
||||
happens.
|
||||
- Two follow-up issues (#89, #90) track the deferred authoring-tooling adaptation and the actual
|
||||
repo conversion, respectively.
|
||||
- Two follow-up issues track the remaining work: #89 (`skill-author`/`agent-author` routing
|
||||
adaptation) and #90 (the actual repo conversion, which also deletes `plugin-author`/
|
||||
`marketplace-author`).
|
||||
|
||||
Reference in New Issue
Block a user