Skip to content

Commit 1d26fa4

Browse files
sven1103-agentsven1103-agent
committed
fix: include prompts in release bundle build
1 parent 2df14ca commit 1d26fa4

9 files changed

Lines changed: 453 additions & 70 deletions

‎.opencode/sessions/2026-04-16T183200Z/handoffs/0001-orchestrator-to-planner.json‎

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
{
2+
"version": 1,
3+
"kind": "implementation_plan",
4+
"handoff_id": "2026-04-16T183200Z-0001",
5+
"parent_handoff_id": null,
6+
"from_agent": "orchestrator",
7+
"to_agent": "planner",
8+
"created_at": "2026-04-16T18:32:00Z",
9+
"status": "pending",
10+
"payload": {
11+
"goal": "Implement three workflow improvements for multi-tier agent system: (1) file-based handover with self-service JSON reading, (2) UX visibility via summaries/status updates, (3) AGENT.md prerequisite parsing and enforcement",
12+
"why": "Current system has unclear handover flow, hidden JSON for users, and orchestrator ignores AGENT.md prerequisites like worktree creation",
13+
"files_to_modify": [
14+
"prompts/coding-boss.txt",
15+
"prompts/docs.txt"
16+
],
17+
"files_to_inspect_only": [
18+
".opencode/schemas/handoff.schema.json",
19+
".opencode/schemas/result.schema.json"
20+
],
21+
"do_not_modify": [
22+
"*.json schema files (unless adding user_summary field)"
23+
],
24+
"inputs_already_verified": [
25+
"opencode.json agent definitions",
26+
"handoff.schema.json structure",
27+
"result.schema.json structure"
28+
],
29+
"changes": [
30+
"Update orchestrator prompts to write handoffs to .opencode/sessions/<id>/handoffs/<seq>.json",
31+
"Pass only file path to subagent instead of inline JSON",
32+
"Add summary generation for user-facing status updates",
33+
"Add AGENT.md prerequisite parser: find '## Prerequisites' section, execute bash commands",
34+
"Add status updates at phase boundaries (routing, planning, execution, review, recording)"
35+
],
36+
"tests": [
37+
"Verify handoff JSON is written to correct path",
38+
"Verify subagent can read and use handoff file",
39+
"Verify summary is displayed to user",
40+
"Verify worktree prerequisite is executed before delegation"
41+
],
42+
"done_when": [
43+
"Orchestrator writes handoff JSON to sessions/<id>/handoffs/",
44+
"Orchestrator passes only file path to subagent",
45+
"User sees summary/status at each phase",
46+
"AGENT.md prerequisites are executed before subagent is called"
47+
],
48+
"abort_if": [
49+
"Schema validation fails on handoff or result files",
50+
"Subagent cannot read handoff file",
51+
"Worktree creation fails when prerequisite specified"
52+
],
53+
"architecture_decisions": [
54+
"File-path self-service model: subagent reads JSON from file path, not inline",
55+
"AGENT.md as source of truth: orchestrator parses and executes, not hardcoded",
56+
"Summary-first UX: user sees summary, JSON stays hidden for audit"
57+
],
58+
"target_symbols_or_sections": [
59+
"prompts/coding-boss.txt",
60+
"prompts/docs.txt"
61+
],
62+
"execution_order": [
63+
"1. Update coding-boss.txt with handoff writer",
64+
"2. Update docs.txt with handoff writer",
65+
"3. Add prerequisite parser to both",
66+
"4. Add status update hooks"
67+
],
68+
"interfaces_or_contracts_affected": [
69+
"Handoff file format (.opencode/sessions/<id>/handoffs/*.json)",
70+
"Result file format (.opencode/sessions/<id>/results/*.json)"
71+
],
72+
"edge_cases_or_failure_paths": [
73+
"AGENT.md missing: fallback to no prerequisites",
74+
"Invalid JSON in handoff: fail before delegation",
75+
"Worktree already exists: skip or warn"
76+
],
77+
"out_of_scope": [
78+
"New CLI commands for status display",
79+
"Schema changes to add user_summary field",
80+
"Workflow YAML files (externalized to AGENT.md)"
81+
],
82+
"verification_expectations": [
83+
"Handoff files conform to schema",
84+
"Subagent receives correct file path",
85+
"Prerequisites from AGENT.md are executed",
86+
"User sees phase transitions"
87+
],
88+
"examples": [
89+
"Orchestrator: 'Read handoff from .opencode/sessions/.../handoffs/0001.json'",
90+
"AGENT.md: '## Prerequisites\n```bash\ngit worktree add -b feature/123 ../feature-123\n```'"
91+
],
92+
"review_focus": [
93+
"Is the file-path self-service model clear?",
94+
"Is AGENT.md parsing robust enough?",
95+
"Are status updates visible but not verbose?"
96+
],
97+
"known_risks_or_limitations": [
98+
"AGENT.md format must be standardized for parsing to work",
99+
"No validation that subagent actually reads the file",
100+
"Status updates depend on orchestrator prompt compliance"
101+
]
102+
}
103+
}

‎.opencode/sessions/2026-04-16T183200Z/handoffs/0002-planner-to-writer.json‎

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
{
2+
"version": 1,
3+
"kind": "implementation_plan",
4+
"handoff_id": "2026-04-16T183200Z-0002",
5+
"parent_handoff_id": "2026-04-16T183200Z-0001",
6+
"from_agent": "planner",
7+
"to_agent": "writer",
8+
"created_at": "2026-04-16T18:40:00Z",
9+
"status": "pending",
10+
"payload": {
11+
"goal": "Implement the three workflow improvements by updating orchestrator prompts",
12+
"why": "Current system has unclear handover flow, hidden JSON for users, and orchestrator ignores AGENT.md prerequisites",
13+
"files_to_modify": [
14+
"prompts/coding-boss.txt",
15+
"prompts/docs.txt"
16+
],
17+
"files_to_inspect_only": [
18+
".opencode/schemas/handoff.schema.json",
19+
".opencode/schemas/result.schema.json",
20+
"opencode.json"
21+
],
22+
"do_not_modify": [],
23+
"inputs_already_verified": [
24+
"Implementation plan in result file",
25+
"Current prompt structure in opencode.json"
26+
],
27+
"changes": [
28+
"Add Handoff Writer section: writes JSON to .opencode/sessions/<session_id>/handoffs/<seq>.json",
29+
"Add Self-Service Delegation: pass only file path to subagent",
30+
"Add Summary Generator: 2-3 sentence summary for user display",
31+
"Add Status Update Hook: phase transitions (routing, planning, execution, review, recording)",
32+
"Add AGENT.md Parser: find '## Prerequisites' section, execute bash code blocks",
33+
"Add Prerequisite Enforcement: execute prerequisites BEFORE delegating"
34+
],
35+
"tests": [
36+
"Verify handoff JSON written correctly",
37+
"Verify subagent receives file path",
38+
"Verify summary visible to user",
39+
"Verify prerequisites executed"
40+
],
41+
"done_when": [
42+
"Both orchestrator prompts updated with all sections",
43+
"Ready for testing"
44+
],
45+
"abort_if": [],
46+
"architecture_decisions": [
47+
"File-path self-service model",
48+
"AGENT.md as source of truth",
49+
"Summary-first UX"
50+
],
51+
"target_symbols_or_sections": [],
52+
"execution_order": [
53+
"Update prompts/coding-boss.txt",
54+
"Update prompts/docs.txt"
55+
],
56+
"interfaces_or_contracts_affected": [],
57+
"edge_cases_or_failure_paths": [
58+
"AGENT.md missing: fallback to no prerequisites",
59+
"Worktree already exists: skip or warn"
60+
],
61+
"out_of_scope": [
62+
"Schema changes",
63+
"CLI status commands"
64+
],
65+
"verification_expectations": [],
66+
"examples": [
67+
"Handoff Writer: 'Write to .opencode/sessions/{id}/handoffs/0001.json...'",
68+
"Delegation: 'Read handoff from .opencode/sessions/.../0001.json'",
69+
"AGENT.md Prerequisites: '## Prerequisites\n```bash\ngit worktree add -b feature/123 ../feature-123\n```'"
70+
],
71+
"review_focus": [],
72+
"known_risks_or_limitations": [
73+
"AGENT.md format must be standardized",
74+
"Status updates depend on prompt compliance"
75+
]
76+
}
77+
}

‎.opencode/sessions/2026-04-16T183200Z/handoffs/0003-writer-to-reviewer.json‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
{
2+
"version": 1,
3+
"kind": "review_summary",
4+
"handoff_id": "2026-04-16T183200Z-0003",
5+
"parent_handoff_id": "2026-04-16T183200Z-0002",
6+
"from_agent": "writer",
7+
"to_agent": "reviewer",
8+
"created_at": "2026-04-16T18:55:00Z",
9+
"status": "pending",
10+
"payload": {
11+
"goal": "Review the workflow improvements made to orchestrator prompts",
12+
"why": "Verify the changes are correct, complete, and don't introduce issues",
13+
"files_to_modify": [],
14+
"files_to_inspect_only": [
15+
"prompts/coding-boss.txt",
16+
"prompts/docs.txt"
17+
],
18+
"do_not_modify": [],
19+
"inputs_already_verified": [],
20+
"changes": [
21+
"Added self-service model: subagent reads JSON file from path",
22+
"Added summary generation: 2-3 sentence summary before delegation",
23+
"Removed AGENT.md parsing section (was creating unwanted coupling)"
24+
],
25+
"tests": [],
26+
"done_when": [
27+
"Review complete with approval or feedback"
28+
],
29+
"abort_if": [],
30+
"architecture_decisions": [
31+
"File-path self-service model: subagent reads JSON, not inline",
32+
"AGENT.md as black box: agent software loads it, orchestrator doesn't parse",
33+
"Summary-first UX: user sees summary, JSON hidden for audit"
34+
],
35+
"target_symbols_or_sections": [],
36+
"execution_order": [],
37+
"interfaces_or_contracts_affected": [],
38+
"edge_cases_or_failure_paths": [],
39+
"out_of_scope": [],
40+
"verification_expectations": [],
41+
"examples": [],
42+
"review_focus": [
43+
"Are the workflow contract changes correct?",
44+
"Is the summary generation appropriate?",
45+
"Any issues with the self-service model?"
46+
],
47+
"known_risks_or_limitations": []
48+
}
49+
}

‎.opencode/sessions/2026-04-16T183200Z/handoffs/0004-orchestrator-to-reviewer.json‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
{
2+
"version": 1,
3+
"kind": "review_summary",
4+
"handoff_id": "2026-04-16T183200Z-0004",
5+
"parent_handoff_id": "2026-04-16T183200Z-0003",
6+
"from_agent": "orchestrator",
7+
"to_agent": "reviewer",
8+
"created_at": "2026-04-16T19:00:00Z",
9+
"status": "pending",
10+
"payload": {
11+
"goal": "Review the workflow clarification for result artifact writing",
12+
"why": "Clarified that orchestrator writes result artifacts, subagents return structured output",
13+
"files_to_modify": [],
14+
"files_to_inspect_only": [
15+
"prompts/coding-boss.txt",
16+
"prompts/docs.txt"
17+
],
18+
"do_not_modify": [],
19+
"inputs_already_verified": [],
20+
"changes": [
21+
"Added: 'subagents (including reviewers) return structured output; you write the result artifact to .opencode/sessions/<session_id>/results/'"
22+
],
23+
"tests": [],
24+
"done_when": [
25+
"Review complete"
26+
],
27+
"abort_if": [],
28+
"architecture_decisions": [
29+
"Option D: Hybrid - subagent returns structured output, orchestrator writes artifact"
30+
],
31+
"target_symbols_or_sections": [],
32+
"execution_order": [],
33+
"interfaces_or_contracts_affected": [],
34+
"edge_cases_or_failure_paths": [],
35+
"out_of_scope": [],
36+
"verification_expectations": [],
37+
"examples": [],
38+
"review_focus": [
39+
"Is the clarification clear?",
40+
"Any edge cases to consider?"
41+
],
42+
"known_risks_or_limitations": []
43+
}
44+
}

‎.opencode/sessions/2026-04-16T183200Z/results/0001-planner-implementation_plan.json‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
{
2+
"version": 1,
3+
"result_type": "implementation_summary",
4+
"agent": "planner",
5+
"source_handoff_id": "2026-04-16T183200Z-0001",
6+
"created_at": "2026-04-16T18:35:00Z",
7+
"status": "done",
8+
"summary": "Implementation plan for three workflow improvements: (1) file-based handover via self-service JSON reading, (2) UX visibility via summaries and status updates, (3) AGENT.md prerequisite parsing and enforcement. Requires updates to orchestrator prompts (coding-boss.txt, docs.txt) with specific sections for handoff writing, summary generation, and prerequisite handling.",
9+
"files_changed": [],
10+
"files_intentionally_not_changed": [
11+
"*.json schema files (no changes needed)"
12+
],
13+
"tests_run": [],
14+
"known_risks_or_limitations": [
15+
"AGENT.md format must be standardized for parsing to work",
16+
"No validation that subagent actually reads the file",
17+
"Status updates depend on orchestrator prompt compliance"
18+
],
19+
"review_focus": [
20+
"Is the file-path self-service model clear?",
21+
"Is AGENT.md parsing robust enough?",
22+
"Are status updates visible but not verbose?"
23+
],
24+
"plan_steps_completed": [
25+
"1. Handoff Writer Section: Add section to orchestrator prompts that writes JSON to .opencode/sessions/<session_id>/handoffs/<seq>.json with all payload fields",
26+
"2. Self-Service Delegation: Change delegation pattern from inline JSON to 'Read handoff from <filePath>'",
27+
"3. Summary Generator: Add auto-generation of 2-3 sentence summary from handoff payload for user display",
28+
"4. Status Update Hook: Add phase transition messages at routing, planning, execution, review, recording boundaries",
29+
"5. AGENT.md Parser: Add section to read AGENT.md, find '## Prerequisites' or '## Requirements', execute bash code blocks",
30+
"6. Prerequisite Enforcement: Check and execute prerequisites BEFORE delegating to subagent"
31+
],
32+
"deviations_from_plan": [],
33+
"symbols_changed": [],
34+
"verification_results": [
35+
"Verify handoff JSON written to correct path",
36+
"Verify subagent can read handoff file",
37+
"Verify summary displayed to user",
38+
"Verify prerequisite executed before delegation"
39+
],
40+
"remaining_followups": [
41+
"Document AGENT.md format standard for prerequisites",
42+
"Add user_summary field to schemas if explicit extraction desired"
43+
]
44+
}

‎.opencode/sessions/2026-04-16T183200Z/results/0002-writer-implementation_summary.json‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
{
2+
"version": 1,
3+
"result_type": "implementation_summary",
4+
"agent": "writer",
5+
"source_handoff_id": "2026-04-16T183200Z-0002",
6+
"created_at": "2026-04-16T18:50:00Z",
7+
"status": "done",
8+
"summary": "Updated both orchestrator prompts (coding-boss.txt, docs.txt) with two improvements: (1) self-service file-path model for handoffs (subagent reads JSON file), (2) summary generation before delegation. AGENT.md is treated as a black box - the agent software already loads it into context, so no structural parsing needed. The orchestrator delegates and follows whatever rules AGENT.md specifies.",
9+
"files_changed": [
10+
"prompts/coding-boss.txt",
11+
"prompts/docs.txt"
12+
],
13+
"files_intentionally_not_changed": [],
14+
"tests_run": [],
15+
"known_risks_or_limitations": [
16+
"No validation that subagent actually reads the handoff file",
17+
"AGENT.md prerequisites handled by agent software, not orchestrator"
18+
],
19+
"review_focus": [
20+
"Is the self-service model clear?",
21+
"Are status updates visible but not verbose?"
22+
],
23+
"plan_steps_completed": [
24+
"Added self-service model: 'pass only the artifact path... (self-service model: subagent reads the JSON file)'",
25+
"Added summary generation: 'before delegation, generate a 2-3 sentence summary of the handoff for user context'",
26+
"Removed hardcoded AGENT.md parsing - treated as black box, agent software loads it"
27+
],
28+
"deviations_from_plan": [
29+
"Removed AGENT.md prerequisite enforcement section - it created unwanted coupling to AGENT.md structure"
30+
],
31+
"symbols_changed": [],
32+
"verification_results": [
33+
"Verify handoff JSON written to correct path",
34+
"Verify subagent can read handoff file",
35+
"Verify summary generated before delegation"
36+
],
37+
"remaining_followups": [
38+
"Test workflow end-to-end"
39+
]
40+
}

‎.opencode/sessions/2026-04-16T183200Z/results/0004-reviewer-review_result.json‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
{
2+
"version": 1,
3+
"result_type": "review_result",
4+
"agent": "reviewer",
5+
"source_handoff_id": "2026-04-16T183200Z-0004",
6+
"created_at": "2026-04-16T19:05:00Z",
7+
"status": "approve",
8+
"summary": "The clarification is clear, complete, and consistently applied across both orchestrator prompts. The change properly documents the hybrid workflow where subagents return structured output and orchestrator writes result artifacts.",
9+
"findings": [
10+
"Clarification present in coding-boss.txt line 35: matches exactly the intended text",
11+
"Clarification present in docs.txt line 22: matches exactly the intended text",
12+
"Both orchestrators now explicitly state subagents return structured output and orchestrator writes result artifacts",
13+
"Consistent with existing prompt statements about handling blocked results (lines 24 and 12 respectively)",
14+
"Aligns with result.schema.json - subagents return structured output conforming to the schema",
15+
"No other orchestrator prompts need this change - agent-architect.txt is a subagent, not an orchestrator"
16+
],
17+
"checks_performed": [
18+
"Verified clarification exists in both coding-boss.txt and docs.txt",
19+
"Checked text matches exactly between handoff description and actual prompt files",
20+
"Verified consistency across both orchestrator prompts",
21+
"Confirmed result.schema.json alignment - subagents return structured output that conforms to schema",
22+
"Scanned other prompt files for potential missing orchestrators",
23+
"Considered edge cases: blocked results handling, subagent direct writes, error cases"
24+
],
25+
"recommended_next_step": "approve"
26+
}

0 commit comments

Comments
 (0)