Docs overview
Public guides for Waykit: the software lifecycle for coding agents, the learning loops around it, the live kit graph and the operator surfaces. Markdown in this directory (plus SOPs/, eval write-ups and MCP/ontology READMEs) is the site. Raw .md URLs stay next to the HTML so agents and llms.txt do not depend on client JavaScript.
pnpm site:dev runs the docs app. pnpm --dir web build then wk site assemble writes site/.
Start
| Page | Who it is for |
|---|---|
| Getting started | First install, handshake, shell completions, then the loops you need |
| Jobs for today | Seven concrete jobs, one command each |
| Common questions | Install, keys, context, repo doctor, tab-complete, how agents find an SOP, where EDD fits |
Practice
| Page | Who it is for |
|---|---|
| Feature lifecycle | Grill → PRD if bet → spec → TDD → XFN → ship |
| Quality loops | Nested loops; CI, RUM, Lighthouse and Sonar into Linear |
| What Waykit gives you | wk CLI: context budget, live kit graph, MCP profiles, check, doctor |
| Repo doctor | Owned-repo README, license, contributing, GitHub templates |
| Consumer align | App-repo handshake, host pointers, kit MCP, commit-msg, reusable PR Action |
| Used on our own product repos | ArchLens, RoMini, steerco, React Cloudflare template, GPIO monitor |
| Waykit map | Live graph of this kit (derived from files, not a second catalog) |
| Author the Waykit map | What becomes a node, how to regenerate, what it is not |
| EDD guide (alpha) | Anyone proving agent tool routing in CI |
| Hosts | Cursor, Claude Code, Copilot, Antigravity files |
| Host subagents | Which SDLC roles become isolated agents vs stay skills |
Reference
| Page | Who it is for |
|---|---|
| SOPs | Agent-facing procedures |
| ADRs | Hard-to-reverse kit decisions |
| Eval suites | YAML/JSONL layout and drivers |
| MCP library | Profiles and servers |
| Ontology schema | Metamodel (phaseOrder, types, memory allowlist) |
Independent assessment: kit value and model-agnostic review, review backlog.