Files
AGENTS/.sisyphus/notepads/chiron-agent-framework/learnings.md
m3tm3re 1252b9ffe7 Create Chiron-Forge build/execution mode system prompt
Define Chiron-Forge as execution/build counterpart to Chiron with:
- Full write access for task execution
- Clear distinction from Chiron's planning/analysis role
- Question tool for destructive operations confirmation
- Workflow: Receive → Understand → Plan Action → Execute → Confirm → Report
- Delegation to subagents for specialized domains

File: prompts/chiron-forge.txt (3185 chars, 67 lines)
2026-02-03 18:49:31 +01:00

2.1 KiB

Learnings - Chiron Agent Framework

Task: Update agents/agents.json with 6 Chiron agents

Agent Configuration Pattern

  • JSON structure: { "agent-name": { "description": "...", "mode": "...", "model": "...", "prompt": "{file:./prompts/...}", "permission": { "question": "..." } } }
  • Two primary agents: chiron (plan mode) and chiron-forge (build mode)
  • Four subagents: hermes (work comm), athena (work knowledge), apollo (private knowledge), calliope (writing)
  • All agents use zai-coding-plan/glm-4.7 model
  • Prompts are file references: {file:./prompts/agent-name.txt}
  • Permissions use simple allow: { "question": "allow" }

Verification

  • JSON validation: python3 -c "import json; json.load(open('agents/agents.json'))"
  • No MCP configuration needed for agent definitions
  • Mode values: "primary" or "subagent"

Files Modified

  • agents/agents.json - Expanded from 1 to 6 agents (8 lines → 57 lines)

Successful Approaches

  • Follow existing JSON structure pattern
  • Maintain consistent indentation and formatting
  • Use file references for prompts (not inline)

Task: Create prompts/chiron-forge.txt

Chiron-Forge Prompt Pattern

  • Purpose: Execution/build mode counterpart to Chiron's planning mode
  • Identity: Worker-mode AI assistant with full write access
  • Core distinction: Chiron = planning/analysis, Chiron-Forge = building/executing
  • Second-person addressing: "You are..." format

Key Components

  • Identity: "execution and build mode counterpart to Chiron"
  • Capabilities: Full write access, read files, create/modify files, execute bash commands
  • Workflow: Receive → Understand → Plan Action → Execute → Confirm (destructive) → Report
  • Safety: Question tool for destructive operations (rm *, git push), sudo denied
  • Delegation: Still delegates to subagents for specialized domains
  • Scope boundaries: NOT planning/analysis agent, NOT evaluation of alternatives

Verification

  • File size: 3185 chars (target >500)
  • Keywords present: execution, build, worker, write
  • Lines: 67

Files Created

  • prompts/chiron-forge.txt - Chiron-Forge build mode system prompt