K Kiyo

Documentation

Kiyo, explained from the current repository.

It explains the rules in human language and keeps examples on the current command style.

Host priority

Kiyo preserves this order whenever host behavior needs to be described.

Claude Code native-first to OpenAI Codex compatible to GitHub Copilot compatible to OpenCode CLI portable Markdown guidance

Short version

Kiyo makes AI coding sessions start from project facts, keep one bounded mission, use existing patterns, avoid invented architecture, and report verification honestly.

Kiyo is not a runtime engine, daemon, database, or autonomous multi-agent platform. It is a set of Markdown rules, skills, workflows, agent contracts, checklists, policies, and response templates that AI coding tools read before they act. Its job is to make AI work more evidence-based, smaller in scope, safer around risky changes, and easier to review.

Examples

  • Project Memory tells the AI what this project actually uses.
  • Mission skills such as /kiyo-bug-fix define a safe workflow for a bounded task.
  • Auto skills such as kiyo-runtime-verification enforce rules even when the user does not explicitly ask for them.

Watch out

  • Kiyo does not replace tests or developer review.
  • Kiyo should not invent project architecture.
  • Kiyo does not run a background service.

Mandatory Priority Order

When sources disagree, Kiyo follows this order.

Project Knowledge Base to Existing Project Pattern to Global Kiyo Skill to Generic Best Practice

Mission flow

A normal Kiyo run moves through a small, reviewable path.

User request to Load Project Memory to Choose one mission to Resolve Safety Mode to Read focused evidence to Plan or change inside scope to Run verification or report why not to Final response with Verification Status

Examples

What you type and what you get.

Before coding a requirement

/kiyo-change-impact-analyzer "add customer export with audit logging"

A read-only impact report with affected layers, likely files, risks, safe order, and AI-ready tasks.

Fixing a bug

/kiyo-bug-fix "coupon makes cart total zero"

A layer-detected root cause fix with regression coverage and Runtime Verification.

Preparing a handover

/kiyo-handover-document-generator "handover for billing support"

A practical guide for maintainers, support, testers, PM or SA, and future AI agents.