Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

docs(agents): document fork task-scope and TaskList access constraints #73

Merged
Defame1297 merged 1 commits from docs/68-70-subagent-orchestration-guidance into main 2026-07-05 13:02:44 +00:00
Conversation 1 Commits 1 Files Changed 1 +6
Claude commented 2026-07-05 13:01:09 +00:00
Collaborator
Copy Link

Adds a "Subagent orchestration" section to the root AGENTS.md covering two orchestration gaps surfaced during the issue #6 gitea plugin redesign session:

  • Forks given a single bounded task must stop once that task is reported complete — they must not continue autonomously picking up further items from a shared TaskList, and must not be given visibility into a shared TaskList that includes governance-gated actions (push, publish, merge) without a fresh confirmation round.
  • TaskGet/TaskUpdate/TaskList are fork-only — fresh (non-fork) subagents cannot access them. Coordinators must own task-list bookkeeping themselves when delegating to fresh agents.

Refs #68, #70 — these will need manual closing after merge (Gitea doesn't auto-close on merge).

Adds a "Subagent orchestration" section to the root `AGENTS.md` covering two orchestration gaps surfaced during the issue #6 gitea plugin redesign session: - Forks given a single bounded task must stop once that task is reported complete — they must not continue autonomously picking up further items from a shared TaskList, and must not be given visibility into a shared TaskList that includes governance-gated actions (push, publish, merge) without a fresh confirmation round. - `TaskGet`/`TaskUpdate`/`TaskList` are fork-only — fresh (non-fork) subagents cannot access them. Coordinators must own task-list bookkeeping themselves when delegating to fresh agents. Refs #68, #70 — these will need manual closing after merge (Gitea doesn't auto-close on merge).
Claude added 1 commit 2026-07-05 13:01:10 +00:00
docs(agents): document fork task-scope and TaskList access constraints 3bab757f29 
Adds a Subagent orchestration section to AGENTS.md so orchestrating
agents know upfront: forks must stop once their assigned task is done
rather than autonomously draining a shared TaskList, governance-gated
actions must not be exposed to forks without a fresh confirmation
round, and TaskGet/TaskUpdate/TaskList are fork-only so the coordinator
must own task-list bookkeeping for fresh subagents itself.

Refs #68, #70

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FNJWdVvdgvZCHi1hZGqgVQ
Defame1297 requested review from Defame1297 2026-07-05 13:02:17 +00:00
Defame1297 approved these changes 2026-07-05 13:02:40 +00:00
Defame1297 merged commit ccc34138a7 into main 2026-07-05 13:02:44 +00:00
Defame1297 deleted branch docs/68-70-subagent-orchestration-guidance 2026-07-05 13:02:44 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Defame1297
Labels
Clear labels
Compat/Breaking
Breaking change that won't be backward compatible
 Kind/Bug
Something is not working
 Kind/Documentation
Documentation changes
 Kind/Enhancement
Improve existing functionality
 Kind/Feature
New functionality
 Kind/Security
This is security issue
 Kind/Testing
Issue or pull request related to testing
Priority
Critical
1
The priority is critical
Priority
High
2
The priority is high
Priority
Low
4
The priority is low
Priority
Medium
3
The priority is medium
Reviewed
Confirmed
1
Issue has been confirmed
Reviewed
Duplicate
2
This issue or pull request already exists
Reviewed
Invalid
3
Invalid issue
Reviewed
Won't Fix
3
This issue won't be fixed
Status
Abandoned
3
Somebody has started to work on this but abandoned work
Status
Blocked
1
Something is blocking this issue or pull request
Status
Need More Info
2
Feedback is required to reproduce issue or to continue work
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Claude renovate-bot Defame1297
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Defame1297/holocron#73
Delete Branch "docs/68-70-subagent-orchestration-guidance"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?