harness-improvement

name	harness-improvement
description	Improve Kandev's AI harness from session learnings or explicit requests. Use when the user asks to record learnings, update or create skills, agents, subagents, commands, AGENTS.md/CLAUDE.md guidance, or adapt harness files across Claude, Codex, Cursor, or OpenCode.

Harness Improvement

Use this skill to turn lessons from real agent sessions into durable harness changes: skills, agents, subagents, commands, scripts, and always-on instruction files.

Planner Entry

The planner may inventory, edit, and validate a small localized harness change directly. Delegate broad cross-platform migration or independent work when it has positive ROI. Do not use Kandev MCP task/session APIs for workers.

Choose The Artifact

Before editing, classify the requested improvement:

• Session learning: recurring failure, workaround, or convention discovered during a session. Read references/session-learnings.md.
• Skill: task-specific playbook loaded on demand. Read references/skills.md.
• Custom agent: an exception that requires the user to explicitly reverse the repository's single-session policy. Read references/agents.md before acting.
• Command: explicitly invoked workflow shortcut. Prefer a skill unless the user wants manual invocation only.
• AGENTS.md / CLAUDE.md / rules: always-on or path-scoped instruction. Read references/instructions.md.
• Cross-platform migration: preserving behavior across Claude, Codex, Cursor, and OpenCode. Read the relevant platform files in references/platforms/.

If the user names a target platform for a skill, command, or instruction file, load only that platform reference. Do not create a custom agent or platform mirror unless the user explicitly requests a policy reversal.