K Kiyo

Specialist Agents

8 role contracts. No runtime agent service.

A Specialist Agent is a Markdown role contract. It tells the AI what job it is playing, what evidence it needs, what actions are allowed, what actions are prohibited, and what output format to use.

Portable across hosts

Claude Code is the native-first host. Codex and GitHub Copilot receive compatible wrappers. OpenCode CLI compatibility is documented through the portable Markdown model.

Agent contract branches to optional role template, Claude Code skill, Codex skill, Copilot prompt, and OpenCode CLI guidance

How an agent run behaves

The contract does not spawn an external service. It shapes the AI response, evidence rules, safety mode, and output so the work is reviewable.

User asks for specialist work to Load specialist contract to Read required evidence to Safety Mode to Read-only report or Scoped change if allowed to Runtime Verification or Follow-up missions

Use when

  • A feature crosses module boundaries.
  • The design has more than one reasonable option.
  • You need a plan before implementation.

Workflow

  • Reads Project Memory and representative source files.
  • Identifies current boundaries, constraints, and existing patterns.
  • Compares design options with trade-offs.
  • Turns the recommendation into small follow-up missions.

Output

  • Architecture options.
  • Recommended direction.
  • Risk and trade-off notes.
  • Implementation sequence.

Guardrails

  • Read-only by default.
  • Does not impose a generic architecture.
  • Does not change code during planning.

Example

/kiyo-architect-planner "plan payment module boundaries"