feat: Add distributed tracking for team coordination#4
Open
johnsonfamily1234 wants to merge 10 commits intocoreyepstein:mainfrom
Open
feat: Add distributed tracking for team coordination#4johnsonfamily1234 wants to merge 10 commits intocoreyepstein:mainfrom
johnsonfamily1234 wants to merge 10 commits intocoreyepstein:mainfrom
Conversation
Add structure.md documenting: - .hq/ directory layout with prd.json, claims.json, sync-log.json - JSON schemas for all three files - .gitignore recommendations Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Added 'Distributed Tracking - Pull from Repo' section to pure-ralph-base.md - Documents pull_from_repo function with: check if exists, read both files, compare by task ID, generate diff summary - Includes diff detection logic and field comparison table - Explicit no-auto-overwrite policy to prevent data loss - Added .hq/prd.json for distributed tracking sync Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added 'Distributed Tracking - Conflict Resolution' section to pure-ralph-base.md: - Task-level diff display format - Merge strategy: per-task, newer updated_at wins - User confirmation prompt with y/n/manual options - Manual resolution flow for ambiguous conflicts - Write-to-both-locations process - Conflict states table Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add Step 2.5 to check for existing .hq/prd.json in target repo - Show existing tasks table when distributed tracking found - Fuzzy match user's description against existing task titles - Prompt user: add to existing, create separate, or cancel Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add claim instructions to pure-ralph-base.md including: - check_claim function for verifying task availability - claim_task function with 24h expiration default - release_claim function for task completion - Warning display format for claimed tasks - Integration with task selection flow Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add comprehensive workflow section that ties together pull, push, claim, and conflict resolution functions into the Pure Ralph session lifecycle. Updates "Your Job" checklist with sync, claim, push, and release steps. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Manual sync command for distributed tracking:
- Default mode: pull and show status diff table
- --push: push local PRD to repo's .hq/
- --claim {id}: claim a specific task
- --release {id}: release a claim
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Created comprehensive workflow.md with: - Full sync lifecycle documentation - Claim/release flow examples - Troubleshooting guide for 7 common conflicts - Best practices for distributed teams Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Updated structure.md to document prompt.md in .hq/ directory
- Scripts now check for .hq/prompt.md and copy from HQ if missing
- Scripts use .hq/prompt.md and .hq/prd.json for all operations
- Prompt now references .hq/prd.json directly (no {{PRD_PATH}} substitution)
- Added Initialize-HqDirectory function to both ps1 and sh scripts
- Enables project-specific prompt evolution and portability
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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
Adds distributed tracking system so teams can share PRD/task status via git, preventing duplicate work and enabling coordination across contributors.
.hq/directory structure for tracking files (prd.json, claims.json, sync-log.json)/sync-tasksslash command for manual sync operations.hq/prompt.mdin target repoknowledge/distributed-tracking/Test plan
.hq/directory structure documentation is complete/sync-taskscommand exists and has correct flags.hq/initialization🤖 Generated with Claude Code