feat: integrate PACT with Claude Code Task system (#112)#113
Open
michael-wojcik wants to merge 10 commits intomainfrom
Open
feat: integrate PACT with Claude Code Task system (#112)#113michael-wojcik wants to merge 10 commits intomainfrom
michael-wojcik wants to merge 10 commits intomainfrom
Conversation
Add comprehensive Task Integration section including: - Hybrid Task Model (phase + specialist subtasks) - Naming conventions for all task types - Metadata schemas for Phase, Specialist, and Workflow tasks - Command integration summary for all PACT workflows - Algedonic task annotation specifications - Key principles for task-based orchestration Part of #112 - PACT Task System Integration
pact-workflows.md: - Add task structure notes to each workflow section - Reference SSOT in pact-protocols.md for schema details algedonic.md: - Add Task Annotation section explaining metadata approach - Document algedonicHalt and algedonicHistory schemas Part of #112 - PACT Task System Integration
orchestrate.md: - Task creation at workflow start (4 phase tasks) - Per-phase task status transitions - Subtask management and handoff capture comPACT.md: - Workflow task creation with specialist subtasks - Parallel subtask pattern peer-review.md: - Reviewer subtasks with verdict/findings structure plan-mode.md: - 4 phase tasks with Plan: prefix - Planner subtasks during Consult phase rePACT.md: - Nested tasks with rePACT: prefix - Parent phase blocking by nested TEST imPACT.md: - Task modification logic for blockers - imPACTHistory tracking schema - META-BLOCK detection threshold Part of #112 - PACT Task System Integration
Add consistent HANDOFF format to all agent definitions: - Produced: artifacts created/modified - Decisions: choices made during work - Uncertainties: items needing orchestrator attention - Open Questions: unresolved items for future work Updated agents: - pact-architect.md (new section) - pact-backend-coder.md (updated) - pact-database-engineer.md (updated) - pact-frontend-coder.md (updated) - pact-preparer.md (new section) - pact-test-engineer.md (updated) Part of #112 - PACT Task System Integration
task-metadata-schema.md: - Complete field definitions for all 3 task types - Phase Task, Specialist Subtask, Workflow Task schemas - Examples and required vs optional field guidance task-integration-guide.md: - How Task system integrates with PACT methodology - Workflow integration details for each command - Best practices and VSM mapping - Migration guide for existing sessions Part of #112 - PACT Task System Integration
- Update verify-protocol-extracts.sh line ranges after Task System Integration - Regenerate extract files to match SSOT (pact-protocols.md) - Align orchestrate.md handoff field names with agent definitions - 'Key context' → 'Decisions' - 'Areas of uncertainty' → 'Uncertainties' - 'Open questions' → 'Open Questions' All 10 protocol extract verifications now pass.
orchestrate.md: - Update handoff example with realistic multi-file output - Demonstrate priority-tagged uncertainties [HIGH] task-metadata-schema.md: - Add validation guidance (Req? columns, required notes) - Add algedonicHistory[].resolution field description - Standardize enum casing to uppercase (HALT, ALERT, SECURITY, etc.) - Add blockedBy auto-resolution clarification - Add troubleshooting section for blocked state recovery task-integration-guide.md: - Add edge cases for blocked status transitions - Add parallel subtask coordination scenarios with examples - Add CODE-to-TEST handoff example in practice - Add circular dependency troubleshooting entry
…ections Agents don't need to know WHY the handoff format exists - they just need to follow it. The task system is managed by the orchestrator, not specialist agents.
Replace dangling reference to agent definitions with inline specialist subtask metadata example.
- Replace TodoWrite with TaskCreate/TaskUpdate across all commands - Add full task examples with subject, description, activeForm, metadata - Fix activeForm to use strings (not objects) in plan-mode and rePACT - Show complete task lifecycle: create, link (addBlockedBy), complete Files updated: orchestrate.md, comPACT.md, peer-review.md, plan-mode.md, rePACT.md, imPACT.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Test plan
Closes #112