Skip to content

feat: Agent standardization v1.2.0 #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jkyberneees merged 1 commit into from
Feb 21, 2026
Merged

feat: Agent standardization v1.2.0 #3

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 35 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Kai: The Universal Brain

## 1. Overview & Vision
**Version:** 1.2.0

Grea## 1. Overview & Vision

Kai is a **Universal Brain** within the OpenCode agent's ecosystem — a single entry point for intelligent orchestration.

Expand Down Expand Up @@ -240,6 +242,16 @@ This section is for engineers maintaining the Kai system itself.
- **Kai Config**: Must be set to `mode: "primary"` and act as the sole decision-maker.
- **Subagent Config**: All subagents must be set to `mode: "subagent"`. They should only respond to `DIRECTIVE` formats from Kai.

### Agent Specification Standard

All agents MUST follow the specification defined in `TEMPLATE.md`. This ensures consistency across the agent ecosystem. Key requirements include:

- **Required Sections**: Core Principles, Input Requirements, Execution Pipeline, Output Format, Performance Targets, Error Handling, Limitations, Completion Report
- **Subagent-Only Sections**: When to Use/When to Escalate, How Kai Uses This Agent
- **Optional Sections**: Agent Interactions, Terminal UX Spec, Quality Checklist

See `TEMPLATE.md` for the full specification template.

### Communication Protocol

Kai communicates with subagents using structured formats to ensure parsing reliability.
Expand Down Expand Up @@ -293,8 +305,9 @@ Agent temperature values control creativity vs. determinism. The ecosystem uses
| Temperature | Agents | Rationale |
| :---------- | :---------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------ |
| `0.1` | @developer, @reviewer, @tester, @devops, @research, @fact-check, @explorer, @quick-reviewer, @dependency-manager, @postmortem | Deterministic tasks — coding, testing, verification. Precision is critical; creativity is not. |
| `0.2` | @kai, @engineering-team, @architect, @doc-fixer, @executive-summarizer, @refactor-advisor | Balanced tasks — orchestration, design, analysis. Some creativity needed for problem-solving, prioritization, and persona expression. |
| `0.3` | @docs | Creative tasks — technical writing. Higher temperature produces more natural, varied prose. |
| `0.15` | @performance-optimizer | Analytical tasks — performance analysis requires measured, data-driven approaches. |
| `0.2` | @kai, @engineering-team, @architect, @doc-fixer, @executive-summarizer, @refactor-advisor, @security-auditor, @integration-specialist | Balanced tasks — orchestration, design, analysis, security. Some creativity needed for problem-solving, prioritization, and persona expression. |
| `0.3` | @docs, @accessibility-expert | Creative tasks — technical writing, accessibility design. Higher temperature produces more natural, varied prose. |

### Terminal UX Spec

Expand Down Expand Up @@ -662,15 +675,19 @@ PIPELINE HEALTH DASHBOARD (Conceptual)
| `@tester` | Specialist | Test automation & QA | < 20 min | 45 min |
| `@docs` | Specialist | Technical writing | < 20 min | 45 min |
| `@devops` | Specialist | CI/CD & Infrastructure | < 30 min | 60 min |
| `@security-auditor` | Quality | Security vulnerability scanning | < 18 min | 30 min |
| `@performance-optimizer`| Quality | Performance analysis & optimization | < 19 min | 35 min |
| `@integration-specialist`| Quality | API design & stub generation | < 18 min | 35 min |
| `@accessibility-expert` | Quality | WCAG compliance & accessibility | < 15 min | 30 min |
| `@research` | Research | Deep-dive investigation | Variable | Variable |
| `@fact-check` | Research | Claim verification | < 15 min | 30 min |
| `@explorer` | Fast-Track | Codebase exploration & navigation | < 5 min | 7 min |
| `@quick-reviewer` | Fast-Track | Small code reviews | < 5 min | 7 min |
| `@doc-fixer` | Fast-Track | Documentation fixes | < 5 min | 7 min |
| `@explorer` | Fast-Track | Codebase exploration & navigation | < 5 min | 7 min |
| `@quick-reviewer` | Fast-Track | Small code reviews | < 5 min | 7 min |
| `@doc-fixer` | Fast-Track | Documentation fixes | < 5 min | 7 min |
| `@dependency-manager` | Fast-Track | Package updates | < 10 min | 15 min |
| `@postmortem` | Learning | Failure analysis & prevention rules | < 5 min | 10 min |
| `@refactor-advisor` | Learning | Tech debt detection & health scoring | < 9 min | 15 min |
| `@executive-summarizer` | Utility | Leadership briefings | < 5 min | 7 min |
| `@postmortem` | Learning | Failure analysis & prevention rules | < 5 min | 10 min |
| `@refactor-advisor` | Learning | Tech debt detection & health scoring | < 9 min | 15 min |
| `@executive-summarizer`| Utility | Leadership briefings | < 5 min | 7 min |

---

Expand All @@ -680,13 +697,22 @@ Each agent file uses semantic versioning independently. The ecosystem version is

```yaml
VERSIONING:
ecosystem_version: "1.2.0"
strategy: "Semantic versioning (MAJOR.MINOR.PATCH)"
scope: "Per-agent + ecosystem-level"

when_to_bump:
MAJOR: "Breaking changes to handoff schema or agent interface"
MINOR: "New capabilities, new agents, new sections"
PATCH: "Bug fixes, typo corrections, clarifications"

v1.2.0_changes:
- "Expanded Quality Agents: @security-auditor, @performance-optimizer, @integration-specialist, @accessibility-expert"
- "Added TEMPLATE.md for agent specification standard"
- "Added Agent Interactions sections to all agents"
- "Added How Kai Uses This Agent sections to all agents"
- "Added .kai directory permissions to all agents"
- "Standardized version to v1.2.0 across all agents"
```

---
Expand Down
Loading