# 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.