- Waykit
- Product guide
- What Waykit gives you
What Waykit gives you
Waykit is the SDLC for coding agents. The rest of this page is what that install actually puts on disk: a thin handshake, on-demand skills, one MCP profile, a quality gate, and learning loops. Eval-driven development is how you prove tool calls; it is not the whole product.
Independent assessment (value + model-/host-agnosticism) and open follow-ups: kit-value-and-model-agnostic-review.md, kit-review-backlog.md.
Always-on context
Agents pay for every byte in the bootstrap. Waykit keeps always-on files small and loads philosophy, SOPs, and skill bodies on demand.
| Surface | In the always-on total? | Target |
|---|---|---|
AGENTS.md + project handshake + thin IDE rules (.cursorrules, CLAUDE.md) | Yes | < ~8KB (~2k tokens) |
| Skill descriptions (frontmatter only) | No (discovery) | Fine; do not pre-load skill bodies |
CODING_PHILOSOPHY.md and SOP files | No | Zero on typo/debug routes unless that procedure is needed |
wk measure-context
Prints a character/token estimate per file and FAIL if always-on exceeds 8KB. Re-run after editing AGENTS.md or the handshake template. wk check runs this gate last.
Agent checklist: SOPs/context-budget.md.
One MCP profile per session
Extra MCP tools compete for attention and inflate tool-schema tokens. Compose one named profile:
wk mcp default --install
wk mcp collab --install
wk mcp ops --install
wk mcp cloudflare-ops --install
Match the profile to the skill’s mcp: frontmatter. Do not merge collab + devtools + ops into one global mcp.json. Catalog: mcps/README.md. Procedure: SOPs/mcp-library.md.
Quality gate
wk check is the local merge bar:
wk audit: prompt injection, secrets, entropy, lockfile pinswk validate/wk verify: eval schemas and skills layoutwk ontology check: live-derived graph refs (depends-on,mcp)- IDE rules match
AGENTS.md - Skill-trigger evals (registration / prompt hygiene; not a model run) and EDD
wk eval ci(scripted, 95% routing) - Context budget
wk check
wk audit
wk sync --install
wk sync installs upstream skills (Cloudflare, Vercel) from skills/external.lock.json by version tag or latest, not a guessed commit SHA. SOPs/external-skills.md.
Live kit graph
Skills, SOPs, MCP servers, evals, and docs are one graph derived from the files agents already edit. You do not maintain a second catalog. wk ontology check fails dangling depends-on and mcp: refs. wk ontology generate writes a gitignored index for kit-knowledge and the public map.
Browse: Waykit map. Authoring: Author the Waykit map. Decision: ADR 0005.
Commands
| Command | What it measures or installs |
|---|---|
wk measure-context | Always-on bootstrap size vs 8KB |
wk check | Audit, ontology, evals, EDD CI, context budget |
wk ontology check | Live graph referential integrity |
wk ontology generate | Write gitignored index for kit-knowledge and the map |
wk mcp <profile> | One MCP profile into mcp.json |
wk audit | Skills and scripts supply-chain scan |
wk eval ci | Routing accuracy gate (EDD) |
wk sync | Upstream skills from the lockfile |
EDD loop, keys, and CI: edd.md.