From f20f5223d51fcfc9816c7e023d9ed8382551d11e Mon Sep 17 00:00:00 2001 From: m3tm3re Date: Tue, 3 Feb 2026 20:14:34 +0100 Subject: [PATCH] Create agents.json with 6 agent definitions (Wave 1, Task 1) - Added all 6 agents: chiron, chiron-forge, hermes, athena, apollo, calliope - Primary agents (2): chiron (Plan Mode), chiron-forge (Build Mode) - Subagents (4): hermes (communications), athena (work knowledge), apollo (private knowledge), calliope (writing) - All agents use model: zai-coding-plan/glm-4.7 - Prompt references use file pattern: {file:./prompts/.txt} - Permission structure: primaries have external_directory rules, subagents have simple question: allow - Verified with Python JSON validation (6 agents, correct names) - Documented patterns and learnings in notepad --- .beads/issues.jsonl | 1 + .../chiron-agent-framework/learnings.md | 73 +++++++++++++++++++ agents/agents.json | 48 ++++++++++++ 3 files changed, 122 insertions(+) create mode 100644 .sisyphus/notepads/chiron-agent-framework/learnings.md diff --git a/.beads/issues.jsonl b/.beads/issues.jsonl index 8ed4c89..33e4bc1 100644 --- a/.beads/issues.jsonl +++ b/.beads/issues.jsonl @@ -12,3 +12,4 @@ {"id":"AGENTS-mfw","title":"Athena agent: Add temperature setting","description":"Athena agent lacks explicit temperature configuration. Per agent-development skill, research/analysis agents should use temperature 0.0-0.2 for focused, deterministic, consistent results. Add 'temperature': 0.1 to agent config in agents.json.","status":"closed","priority":1,"issue_type":"task","owner":"p@m3ta.dev","created_at":"2026-01-24T19:31:55.726506579+01:00","created_by":"m3tm3re","updated_at":"2026-01-26T19:31:06.905697638+01:00","closed_at":"2026-01-26T19:31:06.905697638+01:00","close_reason":"Added 'temperature': 0.1 to athena agent in agent/agents.json for focused, deterministic results"} {"id":"AGENTS-mvv","title":"Enhance daily routines with work context","status":"closed","priority":1,"issue_type":"task","owner":"p@m3ta.dev","created_at":"2026-01-28T18:47:56.066628593+01:00","created_by":"m3tm3re","updated_at":"2026-01-28T18:56:34.576536473+01:00","closed_at":"2026-01-28T18:56:34.576536473+01:00","close_reason":"Enhanced daily-routines skill with full work context integration. Added sections for: morning planning with Basecamp/Outline, evening reflection with work metrics, weekly review with project status tracking, work area health review, work inbox processing."} {"id":"AGENTS-o45","title":"Agent development: Document validation script availability","description":"The agent-development skill references scripts/validate-agent.sh but this script doesn't exist in the repository. Consider either: (1) creating the validation script, or (2) removing the reference and only documenting the python3 alternative.","status":"closed","priority":2,"issue_type":"task","owner":"p@m3ta.dev","created_at":"2026-01-24T19:32:27.325525742+01:00","created_by":"m3tm3re","updated_at":"2026-01-26T19:34:17.846875543+01:00","closed_at":"2026-01-26T19:34:17.846875543+01:00","close_reason":"Removed references to non-existent scripts/validate-agent.sh and documented python3 validation as the primary method"} +{"id":"AGENTS-o7l","title":"Create agents.json with 6 agent definitions","status":"closed","priority":2,"issue_type":"task","owner":"p@m3ta.dev","created_at":"2026-02-03T20:13:02.959856824+01:00","created_by":"m3tm3re","updated_at":"2026-02-03T20:13:58.186033248+01:00","closed_at":"2026-02-03T20:13:58.186033248+01:00","close_reason":"Created agents.json with all 6 agent definitions (chiron, chiron-forge, hermes, athena, apollo, calliope) with proper mode, model, prompt references, and permissions. Verified with Python JSON validation."} diff --git a/.sisyphus/notepads/chiron-agent-framework/learnings.md b/.sisyphus/notepads/chiron-agent-framework/learnings.md new file mode 100644 index 0000000..8be818d --- /dev/null +++ b/.sisyphus/notepads/chiron-agent-framework/learnings.md @@ -0,0 +1,73 @@ +# Learnings - Chiron Agent Framework + +## Wave 1, Task 1: Create agents.json with 6 agent definitions + +### Agent Structure Pattern + +**Required fields per agent:** +- `description`: Clear purpose statement +- `mode`: "primary" for orchestrators, "subagent" for specialists +- `model`: "zai-coding-plan/glm-4.7" (consistent across all agents) +- `prompt`: File reference pattern `{file:./prompts/.txt}` +- `permission`: Either explicit permissions or simple "question": "allow" + +### Primary vs Subagent Modes + +**Primary agents** (2): chiron, chiron-forge +- Can be invoked directly by user +- Orchestrate and delegate work +- Higher permission levels (external_directory rules) + +**Subagents** (4): hermes, athena, apollo, calliope +- Invoked by primary agents via Task tool +- Specialized single-purpose workflows +- Simpler permission structure (question: "allow") + +### Permission Patterns + +**Primary agents**: Complex permission structure +```json +"permission": { + "external_directory": { + "~/p/**": "allow", + "*": "ask" + } +} +``` + +**Subagents**: Simple permission structure +```json +"permission": { + "question": "allow" +} +``` + +### Agent Domains + +1. **chiron**: Plan Mode - Read-only analysis and planning +2. **chiron-forge**: Build Mode - Full execution with safety prompts +3. **hermes**: Work communication (Basecamp, Outlook, Teams) +4. **athena**: Work knowledge (Outline wiki, documentation) +5. **apollo**: Private knowledge (Obsidian vault, personal notes) +6. **calliope**: Writing (documentation, reports, prose) + +### Verification Commands + +**Agent count:** +```bash +python3 -c "import json; data = json.load(open('agents/agents.json')); print(len(data))" +# Expected output: 6 +``` + +**Agent names:** +```bash +python3 -c "import json; data = json.load(open('agents/agents.json')); print(sorted(data.keys()))" +# Expected output: ['apollo', 'athena', 'calliope', 'chiron', 'chiron-forge', 'hermes'] +``` + +### Key Takeaways + +- Prompt files use file references, not inline content (Wave 2 will create these) +- Model is consistent across all agents for predictable behavior +- Permission structure matches agent capability level (more complex for primaries) +- Mode determines how agent can be invoked (direct vs delegated) diff --git a/agents/agents.json b/agents/agents.json index ba99391..89e79fa 100644 --- a/agents/agents.json +++ b/agents/agents.json @@ -10,5 +10,53 @@ "*": "ask" } } + }, + "chiron-forge": { + "description": "Personal AI assistant (Build Mode). Full execution and task completion capabilities with safety prompts.", + "mode": "primary", + "model": "zai-coding-plan/glm-4.7", + "prompt": "{file:./prompts/chiron-forge.txt}", + "permission": { + "external_directory": { + "~/p/**": "allow", + "*": "ask" + } + } + }, + "hermes": { + "description": "Work communication specialist. Handles Basecamp tasks, Outlook email, and MS Teams meetings.", + "mode": "subagent", + "model": "zai-coding-plan/glm-4.7", + "prompt": "{file:./prompts/hermes.txt}", + "permission": { + "question": "allow" + } + }, + "athena": { + "description": "Work knowledge specialist. Manages Outline wiki, documentation, and knowledge organization.", + "mode": "subagent", + "model": "zai-coding-plan/glm-4.7", + "prompt": "{file:./prompts/athena.txt}", + "permission": { + "question": "allow" + } + }, + "apollo": { + "description": "Private knowledge specialist. Manages Obsidian vault, personal notes, and private knowledge graph.", + "mode": "subagent", + "model": "zai-coding-plan/glm-4.7", + "prompt": "{file:./prompts/apollo.txt}", + "permission": { + "question": "allow" + } + }, + "calliope": { + "description": "Writing specialist. Creates documentation, reports, meeting notes, and prose.", + "mode": "subagent", + "model": "zai-coding-plan/glm-4.7", + "prompt": "{file:./prompts/calliope.txt}", + "permission": { + "question": "allow" + } } }