Terrain Knowledge Skill

Terrain stores AI knowledge assets under .terrain/ in this repository (not a global ~/.terrain/knowledge directory). The desktop app registry at ~/.terrain/registry.json only maps slugs → repo paths.

Load rtk-skill when you need to run shell commands during investigation (git, grep repomix file, tests). Resolve tools via conventional paths (~/.terrain/bin/…) with bunx/npx fallback — see rtk-skill / codegraph-skill.

Knowledge layers (mandatory order)

1. Architecture — .terrain/agent/context.md

   • Module map, core flows, system boundaries, tech stack
   • Check .terrain/agent/context-meta.json or meta.json for asset timestamps
   • Read directly (short); no RTK needed

2. Private domain — .terrain/knowledge/**/*.md

   • Business glossary, internal frameworks, APIs, scaffolding guides
   • Team-maintained markdown; read in filename sort order when surveying

3. Structured meta — .terrain/agent/meta-inputs.md

   • Compiled from terrain-meta.json and knowledge/ scans