{"id":43614612,"url":"https://github.com/pyrex41/claude-orc","last_synced_at":"2026-02-04T12:23:46.056Z","repository":{"id":319168341,"uuid":"1077808734","full_name":"pyrex41/claude-orc","owner":"pyrex41","description":null,"archived":false,"fork":false,"pushed_at":"2025-10-17T04:27:53.000Z","size":265,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-17T23:30:51.875Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Common Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pyrex41.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-16T19:12:28.000Z","updated_at":"2025-10-17T04:27:54.000Z","dependencies_parsed_at":"2025-10-18T09:34:12.735Z","dependency_job_id":"44ccc53e-5da0-443c-9b93-5661599507ed","html_url":"https://github.com/pyrex41/claude-orc","commit_stats":null,"previous_names":["pyrex41/claude-orc"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/pyrex41/claude-orc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrex41%2Fclaude-orc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrex41%2Fclaude-orc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrex41%2Fclaude-orc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrex41%2Fclaude-orc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pyrex41","download_url":"https://codeload.github.com/pyrex41/claude-orc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrex41%2Fclaude-orc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29084187,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T03:31:03.593Z","status":"ssl_error","status_checked_at":"2026-02-04T03:29:50.742Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-04T12:23:45.995Z","updated_at":"2026-02-04T12:23:46.048Z","avatar_url":"https://github.com/pyrex41.png","language":"Common Lisp","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PAOS - Parallel Agent Orchestration System\n\nA Common Lisp system for orchestrating multiple Claude Code agents to work on task decomposition and development workflows in parallel.\n\n## Overview\n\nPAOS (Parallel Agent Orchestration System) is a terminal-based multi-agent orchestration platform that:\n\n1. Parses PRDs into structured tasks using AI\n2. Spawns Claude Code instances in isolated Git worktrees\n3. Manages agents through a Zellij-based terminal interface\n4. Provides real-time monitoring and human-in-the-loop interaction\n5. Handles conflict detection and coordinated merging\n\n## Current Status\n\n**Development Progress: 25/25 Tasks Complete (100%)** 🎉\n\n### ✅ Completed Components (Session Progress)\n\n#### Foundation (Tasks 1-3, 7)\n1. **Project Setup** - SBCL, Quicklisp, ASDF with all dependencies\n2. **Configuration** - YAML config, env vars, API key management\n3. **Task Decomposition** - Taskmaster CLI integration\n4. **Git Worktrees** - Isolated development environments\n\n#### Enhanced Features (Tasks 4-6)\n5. **PRD Parsing** - Multi-format support (Markdown, YAML, Plain Text)\n   - AI-enhanced analysis with Claude\n   - Quality assessment and ambiguity resolution\n   \n6. **Intelligent Tagging** - Domain-specific task categorization\n   - AI-powered tagging (ui, backend, database, etc.)\n   - Parallel execution grouping\n   - Dependency-aware planning\n   \n7. **Subtask Expansion** - Hierarchical decomposition (2-3 levels)\n   - Claude API for atomic subtask generation\n   - Coverage validation\n   - Complexity analysis\n\n#### Orchestration (Tasks 8, 10, 14)\n8. **Sub-Agent Spawning** - Zellij terminal multiplexer integration\n   - Tab creation and management\n   - Claude Code agent spawning\n   - Context file generation\n   \n9. **Real-Time Dashboard** - ANSI terminal UI\n   - Progress bars and status indicators\n   - Flicker-free differential rendering\n   - Background update thread\n   \n10. **Human-in-the-Loop REPL** - Interactive command interface\n    - Status monitoring and agent control\n    - Direct agent communication\n    - Command history and validation\n\n#### Core Infrastructure (Tasks 9, 11)\n11. **Agent-Computer Interface (ACI)** - Tool definitions for agents\n    - 8 core tools (git, filesystem, task management)\n    - JSON schema validation\n    - Safety and command whitelisting\n    \n12. **Agent Status Protocol** - JSON-based communication\n    - Status file reading/writing\n    - Change detection and polling\n    - Monitoring loop with callbacks\n\n### ✅ ALL TASKS COMPLETE!\n\n**Core Infrastructure:** ✅ 100%\n- Tasks 1-3, 7: Foundation (config, decomposition, git)\n- Tasks 9, 11: Communication (ACI, status protocol)\n\n**Enhanced Features:** ✅ 100%\n- Tasks 4-6: Parsing, tagging, expansion\n\n**Orchestration Platform:** ✅ 100%\n- Tasks 8, 10, 14-17: Agent spawning, dashboard, REPL, checkpoints\n\n**Intelligence \u0026 Automation:** ✅ 100%\n- Tasks 12-13, 18-20: AI analysis, conflicts, PR workflow\n\n**Infrastructure:** ✅ 100%\n- Tasks 21-25: Performance, reliability, security, usability, maintainability\n\n## Features\n\n- **Task Decomposition**: Automatically break down PRDs into structured tasks using Claude API\n- **Multi-Agent Coordination**: Spawn and manage multiple Claude Code instances in parallel\n- **Git Worktree Management**: Isolated development environments for each agent group\n- **Configuration System**: YAML-based configuration with environment variable support\n- **Taskmaster Integration**: CLI-based task decomposition and management\n- **Real-Time Monitoring**: Terminal-based dashboard showing agent progress\n- **Human-in-the-Loop**: Interactive REPL interface for oversight and control\n- **Conflict Detection**: Proactive identification of merge conflicts and dependencies\n- **Pull Request Management**: Automated PR creation with rich context\n\n## Requirements\n\n- SBCL (Steel Bank Common Lisp) \u003e= 2.5.9\n- Quicklisp package manager\n- Task Master CLI (for task decomposition)\n- Zellij terminal multiplexer (for agent spawning)\n- Claude API access (for AI-powered features)\n\n## Installation\n\n```bash\n# Install dependencies\nbrew install sbcl\n\n# Load the system\nsbcl --eval \"(ql:quickload :paos)\"\n```\n\n## Usage\n\n### Basic Usage\n\n```lisp\n;; Load configuration\n(paos/core:load-config)\n\n;; Decompose a PRD\n(paos/core:decompose-prd \"path/to/prd.txt\" :num-tasks 5 :tag \"feature-x\")\n\n;; Create a worktree for an agent\n(paos/core:create-worktree \"ui-agent\")\n\n;; List all worktrees\n(paos/core:list-worktrees)\n```\n\n### Configuration\n\nCreate `.paos/config.yaml`:\n\n```yaml\n# API Keys (can be overridden by environment variables)\napi_keys:\n  anthropic: \"\"  # ANTHROPIC_API_KEY env var\n  openai: \"\"     # OPENAI_API_KEY env var\n\n# Worktree Configuration\nworktree:\n  root: \".paos/worktrees\"\n\n# Agent Configuration\nagents:\n  max_concurrent: 5\n  timeout: 3600\n```\n\n## Architecture\n\nThe system consists of several key components:\n\n### Core Modules (`core/`)\n\n- **`package.lisp`**: Package definitions and exports\n- **`config.lisp`**: Configuration management and validation\n- **`decomposer.lisp`**: Taskmaster CLI integration for PRD decomposition\n- **`git.lisp`**: Git worktree management and branch handling\n\n### Planned Modules (`src/`)\n\n- **`taskmaster.lisp`**: Enhanced Taskmaster integration\n- **`prd-parser.lisp`**: Multi-format PRD parsing\n- **`tagger.lisp`**: Intelligent task tagging with Claude\n- **`expander.lisp`**: Subtask expansion\n- **`zellij.lisp`**: Terminal multiplexer integration\n- **`dashboard.lisp`**: Real-time status UI\n- **`orchestrator.lisp`**: Main orchestration logic\n- **`monitor.lisp`**: Agent status monitoring\n\n### Integrations (`integrations/`)\n\n- **`github.lisp`**: Pull request management\n- **`review.lisp`**: Code review assistance\n- **`merge.lisp`**: Merge coordination\n\n## Development\n\nThis project uses Task Master for project management. See `.taskmaster/` directory for task definitions and status.\n\n### Current Task Progress\n\n```bash\ntask-master list  # View current tasks\ntask-master show \u003cid\u003e  # View task details\ntask-master next  # Get next task to work on\n```\n\n### Development Workflow\n\n1. **Task Planning**: Use Taskmaster to decompose PRDs into structured tasks\n2. **Agent Spawning**: Create isolated Git worktrees for each agent\n3. **Parallel Development**: Launch Claude Code instances in Zellij tabs\n4. **Monitoring**: Real-time dashboard and status tracking\n5. **Conflict Resolution**: Automated conflict detection and resolution\n6. **Merge Coordination**: Dependency-aware merging and PR creation\n\n## Testing\n\n```bash\n# Load and test the system\nsbcl --eval \"(ql:quickload :paos)\" --eval \"(paos/core:load-config)\" --eval \"(print \\\"PAOS loaded successfully\\\")\"\n```\n\n## Contributing\n\n1. Check current task status: `task-master list`\n2. Pick a task: `task-master next`\n3. Implement the functionality\n4. Update task status: `task-master set-status --id=\u003cid\u003e --status=done`\n5. Commit changes with descriptive messages\n\n## License\n\nMIT License - see LICENSE file for details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyrex41%2Fclaude-orc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpyrex41%2Fclaude-orc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyrex41%2Fclaude-orc/lists"}