Michał Kopeć
0c06cb64ab
Commit all in-flight work — ckb-module and ckb-reset skills, the .agents/modules/ scaffold, OPENSPEC docs, decision records D-0001 and D-0002, graph edges and workload summaries — so the reset that follows is fully recoverable. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
59 lines
2.4 KiB
YAML
59 lines
2.4 KiB
YAML
# Cascade KB module manifest — read by `ckb-module` on install/uninstall.
|
|
# See wiki/decisions/0001-opt-in-file-based-kb-modules.md for why modules are
|
|
# files in the repo rather than native agent plugins.
|
|
name: software
|
|
title: Software / source-code KB
|
|
version: 1.0.0
|
|
requires_kb_schema: "1.5"
|
|
summary: >
|
|
Turns this knowledge base into one that documents software you are building:
|
|
source repos live as gitignored plain clones in src/, and OpenSpec drives
|
|
iterative development at both KB-root and per-repo level.
|
|
|
|
# Skills copied into .agents/skills/ on install, removed on uninstall.
|
|
# .claude/skills is a symlink to .agents/skills, so there is no second copy.
|
|
skills:
|
|
- ckb-code-map
|
|
- ckb-spec
|
|
|
|
# Directories created on install. Never removed on uninstall — they may hold
|
|
# the user's clones and specs.
|
|
scaffold:
|
|
- path: src/
|
|
from: scaffold/src-README.md
|
|
as: src/README.md
|
|
note: Drop zone for source repos, one clone per subdirectory.
|
|
- path: openspec/
|
|
from: scaffold/openspec/
|
|
note: KB-root, cross-cutting specs spanning multiple src/ repos.
|
|
|
|
# Appended to AGENTS.md between the module markers, removed on uninstall.
|
|
agents_fragment: fragments/agents-routing.md
|
|
|
|
# Appended to .gitignore between the module markers, removed on uninstall.
|
|
gitignore_fragment: fragments/gitignore.snippet
|
|
|
|
# Frontmatter this module contributes to the page schema. Additive: the base
|
|
# schema tolerates these whether or not the module is installed.
|
|
schema_additions:
|
|
types:
|
|
- repository # one src/ repo: remote, branch, language, build, owner
|
|
- component # a module/service/package inside a repo
|
|
- spec # a capability spec, KB-root or repo-level
|
|
fields:
|
|
- repo # /wiki/entities/<repo>.md this page belongs to
|
|
- commit # commit hash the page was generated from
|
|
- spec_id # OpenSpec capability id
|
|
- implements # repo-level spec -> the KB-root spec it implements
|
|
- implemented_by # KB-root spec -> repo-level specs implementing it
|
|
|
|
# External dependency. The module reports its absence rather than substituting
|
|
# its own workflow — see wiki/decisions/0002-software-module-design.md.
|
|
depends_on:
|
|
- name: openspec
|
|
scope: src-repo-level-only
|
|
check: "command -v openspec"
|
|
optional: true
|
|
note: >
|
|
Required only for per-repo specs. The KB-root spec layer is served by
|
|
ckb-spec itself and works without the CLI.
|