open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions

docs(voyage): add three-tier ecosystem context brief

Browse source 
New docs/three-tier-context.md (110 lines) documents Voyage's position as
Tier 1 in a three-tier ecosystem with upstream consumers (app-creator,
app-factory; both currently in private incubation). The brief identifies
upstream-consumed contracts (brief.md format, /trekplan CLI, handover
schemas), prescribes stability principles, and explicitly preserves
Voyage's runtime agnosticism — no imports, no detection, no special cases.
Awareness without coupling.

CLAUDE.md § Architecture: 2-line callout pointing to the brief, following
the existing "opt-in upstream architect plugin" precedent.

No Voyage behavior change. Documentation-only.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-05-10 16:29:28 +02:00
commit 68842cf773
2 changed files with 115 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

2
plugins/voyage/CLAUDE.md
View file

@ -255,6 +255,8 @@ Local Docker Compose stack: `examples/observability/`. Operator docs: `docs/obse
No code-level dependency between plugins — the contract is filesystem-level only.
**Upstream consumers (informational, no coupling):** Voyage's brief format and handover schemas are consumed by upstream tooling (currently `app-creator` and `app-factory` in private incubation; both pre-design). Voyage stays agnostic — no imports, no detection, no special cases. See `docs/three-tier-context.md` for the awareness brief that informs decisions about contract stability without introducing coupling.
## State
All artifacts in one project directory (default):