claudevn-patterns

Category: Tools & Productivity | Uploader: trueorc | Downloads: 0 | Version: v1.0（Latest）

Coding patterns extracted from ClaudeVN AI agent orchestration platform

Changelog: Source: GitHub https://github.com/trueorc/claudevn

Directory Structure

Current level: Root

📁 .claude/
- 📁 commands/
  - 📄 analyze-feature.md 5.7 KB
  - 📄 audit-feature.md 4.8 KB
  - 📄 code-issue.md 14.7 KB
  - 📄 fix-conflicts.md 4.3 KB
- 📁 instincts/
  - 📄 api-routes.yaml 1.8 KB
  - 📄 branch-naming.yaml 720 B
  - 📄 commit-convention.yaml 909 B
  - 📄 mcp-tools.yaml 2.7 KB
  - 📄 pr-workflow.yaml 1.1 KB
  - 📄 pydantic-models.yaml 1.2 KB
  - 📄 react-components.yaml 1.9 KB
  - 📄 service-layer.yaml 1.9 KB
  - 📄 skill-definition.yaml 1.3 KB
  - 📄 test-file-structure.yaml 1.5 KB
📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug-report.md 384 B
  - 📄 feature-request.md 372 B
- 📁 workflows/
  - 📄 test.yml 1.7 KB
- 📄 FUNDING.yml 18 B
- 📄 PULL_REQUEST_TEMPLATE.md 182 B
📁 compute/
- 📁 api/
  - 📄 __init__.py 85 B
  - 📄 health.py 764 B
- 📁 images/
  - 📁 fullstack/
    
    📄 detect-capabilities.sh 3.2 KB
    
    📄 Dockerfile 2.9 KB
  - 📁 node/
    
    📄 detect-capabilities.sh 3.2 KB
    
    📄 Dockerfile 2.6 KB
  - 📁 python-testing/
    
    📄 detect-capabilities.sh 3.2 KB
    
    📄 Dockerfile 2.7 KB
- 📁 models/
  - 📄 __init__.py 307 B
  - 📄 instance.py 6.5 KB
- 📁 services/
  - 📄 __init__.py 468 B
  - 📄 claude_code_spawner.py 79.2 KB
  - 📄 claude_sdk_executor.py 9.9 KB
  - 📄 conflict_handler.py 15.0 KB
  - 📄 credential_monitor.py 15.6 KB
  - 📄 sse_event_client.py 32.3 KB
- 📁 tests/
  - 📁 integration/
    
    📄 __init__.py 389 B
    
    📄 conftest.py 1.4 KB
    
    📄 test_compute_serving_integration.py 27.3 KB
    
    📄 test_container_networking.py 16.3 KB
    
    📄 test_container_startup.py 15.1 KB
    
    📄 test_git_operations_live.py 21.8 KB
    
    📄 test_health_endpoint.py 15.8 KB
  - 📁 unit/
    
    📄 __init__.py 39 B
    
    📄 test_auth_token_handler.py 11.7 KB
    
    📄 test_claude_code_spawner.py 142.8 KB
    
    📄 test_claude_sdk_executor.py 14.5 KB
    
    📄 test_config.py 2.3 KB
    
    📄 test_conflict_handler.py 21.6 KB
    
    📄 test_credential_auto_refresh.py 6.6 KB
    
    📄 test_credential_monitor.py 13.7 KB
    
    📄 test_credential_monitor_serving.py 4.7 KB
    
    📄 test_entrypoint.py 10.2 KB
    
    📄 test_health_credentials.py 1.1 KB
    
    📄 test_sse_approved_rejected.py 6.9 KB
    
    📄 test_sse_event_client.py 64.4 KB
    
    📄 test_sse_event_client_registration.py 14.8 KB
  - 📄 __init__.py 40 B
  - 📄 conftest.py 427 B
  - 📄 test_config.py 4.2 KB
  - 📄 test_heartbeat_healthcheck.py 4.2 KB
  - 📄 test_model_selection.py 3.9 KB
- 📄 .gitignore 284 B
- 📄 app.py 12.8 KB
- 📄 config.py 7.8 KB
- 📄 detect-runtimes.sh 3.3 KB
- 📄 Dockerfile 3.9 KB
- 📄 entrypoint.sh 3.8 KB
- 📄 main.py 1.4 KB
- 📄 MIGRATION_v1.0.md 5.0 KB
- 📄 README.md 12.9 KB
- 📄 requirements.txt 623 B
- 📄 start.sh 3.7 KB
- 📄 stop.sh 1.6 KB
📁 deploy/
- 📁 cloud/
  - 📄 .env.cloud.example 823 B
  - 📄 Caddyfile 781 B
  - 📄 cognito-user-pool.yaml 3.6 KB
  - 📄 docker-compose.cloud.yml 1.7 KB
📁 docs/
- 📁 archive/
  - 📁 frontend-v0/
    
    📁 public/
    
    📄 vite.svg 1.5 KB
    
    📁 src/
    
    📁 assets/
    
    📄 react.svg 4.0 KB
    
    📁 components/
    
    📄 ComputeRegistry.css 7.1 KB
    
    📄 ComputeRegistry.jsx 10.3 KB
    
    📄 Dashboard.css 11.9 KB
    
    📄 Dashboard.jsx 18.1 KB
    
    📄 LogsModal.css 5.1 KB
    
    📄 LogsModal.jsx 4.7 KB
    
    📄 ObservabilityDashboard.css 5.6 KB
    
    📄 ObservabilityDashboard.jsx 11.1 KB
    
    📄 ProcessMapViewer.css 20.2 KB
    
    📄 ProcessMapViewer.jsx 35.9 KB
    
    📄 ResourcesView.css 5.3 KB
    
    📄 ResourcesView.jsx 8.5 KB
    
    📄 SessionDetailView.css 4.5 KB
    
    📄 SessionDetailView.jsx 10.2 KB
    
    📄 TaskSubmission.css 5.8 KB
    
    📄 TaskSubmission.jsx 11.8 KB
    
    📄 TimelineView.css 4.7 KB
    
    📄 TimelineView.jsx 10.6 KB
    
    📄 WorkflowView.css 7.7 KB
    
    📄 WorkflowView.jsx 12.3 KB
    
    📁 hooks/
    
    📄 useObservability.js 5.0 KB
    
    📁 services/
    
    📄 observabilityWebSocket.js 7.6 KB
    
    📄 api.js 14.0 KB
    
    📄 App.css 3.3 KB
    
    📄 App.jsx 2.2 KB
    
    📄 index.css 232 B
    
    📄 main.jsx 229 B
    
    📄 .gitignore 253 B
    
    📄 eslint.config.js 758 B
    
    📄 index.html 357 B
    
    📄 package-lock.json 96.1 KB
    
    📄 package.json 604 B
    
    📄 README.md 1.1 KB
    
    📄 vite.config.js 366 B
  - 📄 DOCKER_README.md 4.8 KB
  - 📄 MARKETPLACE_AUTO_REGISTRATION.md 3.7 KB
- 📁 audit/
  - 📄 backlog-buckets-audit-2026-02-27.md 5.5 KB
  - 📄 comprehensive-module-audit-2026-01-28.md 11.4 KB
  - 📄 compute-auth-audit-2026-02-13.md 9.6 KB
  - 📄 compute-registration-audit-2026-02-28.md 5.2 KB
  - 📄 goal-decomposition-audit-2026-02-05.md 3.9 KB
  - 📄 marketplace-audit-2026-02-28.md 7.3 KB
  - 📄 serving-centric-auth-audit-2026-02-14.md 22.1 KB
  - 📄 serving-ui-audit-2026-01-28.md 9.7 KB
  - 📄 v1.0-architecture-audit-2026-01-30.md 16.1 KB
  - 📄 work-management-framework-audit-2026-02-11.md 11.0 KB
- 📁 design/
  - 📁 adr/
    
    📄 001-marketplace-embedded-in-serving.md 3.0 KB
    
    📄 002-marketplace-separate-component.md 3.1 KB
    
    📄 003-work-assignment-notification-fetch.md 4.4 KB
    
    📄 004-slim-claude-code-orchestration.md 6.0 KB
    
    📄 005-dual-spawner-architecture.md 6.0 KB
    
    📄 006-tls-termination-caddy-vs-cloud-lb.md 5.7 KB
  - 📁 architecture/
    
    📄 v1.0-architecture.md 20.5 KB
  - 📁 specifications/
    
    📄 characterization-pipeline.md 7.4 KB
    
    📄 compute-registration.md 10.8 KB
    
    📄 conflict-taxonomy.md 7.1 KB
    
    📄 git-infrastructure.md 23.4 KB
    
    📄 mcp-tools.md 13.7 KB
    
    📄 ontology-system.md 6.2 KB
    
    📄 persona-marketplace.md 1.0 KB
    
    📄 skill-marketplace.md 36.1 KB
    
    📄 slim-claude-code.md 13.8 KB
    
    📄 ssh-server-architecture.md 14.2 KB
    
    📄 work-orchestrator.md 35.2 KB
    
    📄 workmap.md 13.2 KB
- 📁 guides/
  - 📄 auth-setup.md 12.5 KB
  - 📄 cognito-setup.md 4.8 KB
  - 📄 core-use-cases.md 6.8 KB
  - 📄 distributed-deployment.md 8.6 KB
  - 📄 docker-authentication.md 14.8 KB
  - 📄 issue-creation-guide.md 7.0 KB
  - 📄 local-data-inspection.md 1.5 KB
  - 📄 remote-compute.md 24.8 KB
  - 📄 serving-ui-guide.md 5.3 KB
  - 📄 test-tier-strategy.md 8.2 KB
  - 📄 testing.md 4.9 KB
  - 📄 uat-checklist.md 18.7 KB
  - 📄 worktree-workflow.md 8.2 KB
- 📄 architecture-overview.md 22.0 KB
- 📄 configuration-reference.md 22.1 KB
- 📄 getting-started.md 12.3 KB
- 📄 mcp-tools-reference.md 17.7 KB
- 📄 README.md 8.5 KB
- 📄 skill-authoring-guide.md 17.2 KB
- 📄 troubleshooting.md 17.0 KB
- 📄 work_management_framework.md 22.1 KB
📁 examples/
- 📁 demo-data/
  - 📁 sample_codebase/
    
    📄 app.py 3.9 KB
    
    📄 models.py 1.8 KB
    
    📄 tests.py 1.8 KB
    
    📄 utils.py 3.3 KB
  - 📄 README.md 1.8 KB
  - 📄 sales_q4_2024.csv 5.5 KB
📁 marketplace/
- 📁 personas/
  - 📁 system/
    
    📄 fullstack-developer.yaml 1.5 KB
    
    📄 orchestrator.yaml 1.8 KB
- 📁 services/
  - 📄 __init__.py 137 B
  - 📄 authorization_audit_service.py 7.1 KB
  - 📄 registration_client.py 10.1 KB
  - 📄 skill_usage_service.py 2.9 KB
- 📁 skills/
  - 📁 system/
    
    📄 api-integration.yaml 3.2 KB
    
    📄 bug-investigation.yaml 2.8 KB
    
    📄 characterizer.yaml 7.0 KB
    
    📄 code-analysis.yaml 2.1 KB
    
    📄 code-implementation.yaml 2.4 KB
    
    📄 code-reviewer.yaml 1.5 KB
    
    📄 code-writer.yaml 2.3 KB
    
    📄 database-migration.yaml 2.9 KB
    
    📄 debugger.yaml 2.4 KB
    
    📄 doc-writer.yaml 2.5 KB
    
    📄 documentation.yaml 2.8 KB
    
    📄 git-operations.yaml 2.1 KB
    
    📄 goal-decomposer.yaml 5.4 KB
    
    📄 planner.yaml 5.1 KB
    
    📄 prod-deployment.yaml 2.3 KB
    
    📄 security-audit.yaml 2.7 KB
    
    📄 security-reviewer.yaml 1.7 KB
    
    📄 test-automator.yaml 2.4 KB
    
    📄 test-creation.yaml 2.7 KB
- 📁 skills-extended/
  - 📁 system/
    
    📄 devops-engineer.yaml 1.2 KB
    
    📄 performance-analyst.yaml 1.1 KB
- 📁 tests/
  - 📁 integration/
    
    📄 test_api_integration.py 51.0 KB
  - 📁 unit/
    
    📄 test_agents_api.py 6.8 KB
    
    📄 test_app.py 23.3 KB
    
    📄 test_authorization_audit_service.py 18.1 KB
    
    📄 test_catalog_api.py 8.8 KB
    
    📄 test_characterizer_skill.py 7.8 KB
    
    📄 test_composition_service.py 58.3 KB
    
    📄 test_config.py 10.5 KB
    
    📄 test_git_storage.py 17.6 KB
    
    📄 test_persona_registry.py 15.2 KB
    
    📄 test_persona_skill_invalidation.py 15.1 KB
    
    📄 test_persona_versioning.py 11.3 KB
    
    📄 test_persona_versioning_api.py 7.6 KB
    
    📄 test_registration_client.py 7.4 KB
    
    📄 test_skill_registry.py 29.0 KB
    
    📄 test_skill_registry_git.py 17.7 KB
    
    📄 test_system_skill_tools.py 10.7 KB
    
    📄 test_tool_api.py 19.4 KB
    
    📄 test_versioning_api.py 4.2 KB
  - 📄 __init__.py 39 B
  - 📄 conftest.py 449 B
  - 📄 test_model_selection.py 2.2 KB
  - 📄 test_skill_marketplace_source.py 3.4 KB
- 📁 tools/
  - 📄 specialized.yaml 3.7 KB
- 📄 .gitignore 382 B
- 📄 api.py 47.9 KB
- 📄 app.py 10.3 KB
- 📄 composition_service.py 28.5 KB
- 📄 config.py 3.2 KB
- 📄 Dockerfile 982 B
- 📄 git_storage.py 13.0 KB
- 📄 models.py 30.0 KB
- 📄 persona_registry.py 24.6 KB
- 📄 QUICKSTART.md 4.7 KB
- 📄 README.md 19.1 KB
- 📄 requirements.txt 126 B
- 📄 skill_registry.py 28.8 KB
📁 scripts/
- 📁 demo_data/
  - 📄 __init__.py 365 B
  - 📄 __main__.py 10.6 KB
  - 📄 cli.py 37.3 KB
  - 📄 compute.py 5.0 KB
  - 📄 phase1_foundation.py 10.4 KB
  - 📄 phase2_execution.py 13.9 KB
  - 📄 phase3_growth.py 19.5 KB
  - 📄 skills.py 11.3 KB
- 📁 tests/
  - 📄 __init__.py 24 B
  - 📄 test_demo_data.py 13.3 KB
- 📄 demo_data.py 557 B
- 📄 demo_data.sh 8.8 KB
- 📄 migrate_hooks.py 4.4 KB
- 📄 run_integration_summary.sh 3.2 KB
- 📄 run_integration_tests.sh 9.3 KB
- 📄 run_tests.sh 4.1 KB
- 📄 run_unit_summary.sh 3.0 KB
- 📄 run_unit_tests.sh 6.5 KB
- 📄 setup-cognito.sh 11.9 KB
- 📄 teardown-cognito.sh 7.9 KB
📁 serving/
- 📁 api/
  - 📁 storage_api/
    
    📄 __init__.py 638 B
    
    📄 dependencies.py 441 B
    
    📄 download.py 1.6 KB
    
    📄 management.py 1.7 KB
    
    📄 metadata.py 2.1 KB
    
    📄 models.py 700 B
    
    📄 session.py 1.3 KB
    
    📄 upload.py 2.4 KB
  - 📄 agents.py 8.1 KB
  - 📄 auth.py 4.9 KB
  - 📄 cache.py 3.3 KB
  - 📄 characterization.py 5.8 KB
  - 📄 cognito_users.py 3.0 KB
  - 📄 compute.py 88.4 KB
  - 📄 compute_approval.py 4.9 KB
  - 📄 conflicts.py 6.3 KB
  - 📄 decision_traces.py 3.8 KB
  - 📄 facilitated_sessions.py 20.9 KB
  - 📄 feedback.py 2.8 KB
  - 📄 git.py 26.1 KB
  - 📄 logs.py 6.2 KB
  - 📄 marketplaces.py 10.0 KB
  - 📄 network_capacity.py 2.8 KB
  - 📄 notifications.py 2.8 KB
  - 📄 observability.py 6.9 KB
  - 📄 orchestrator.py 3.0 KB
  - 📄 pipelines.py 4.9 KB
  - 📄 plan_summary.py 8.1 KB
  - 📄 process_maps.py 23.3 KB
  - 📄 profile_presets.py 5.5 KB
  - 📄 projects.py 13.1 KB
  - 📄 provisioner.py 1.4 KB
  - 📄 skills.py 14.3 KB
  - 📄 slim_claude_code.py 56.9 KB
  - 📄 spawner.py 5.0 KB
  - 📄 specialization.py 4.2 KB
  - 📄 storage.py 9.0 KB
  - 📄 tasks.py 12.3 KB
  - 📄 timing.py 2.1 KB
  - 📄 unified_directives.py 4.0 KB
  - 📄 users.py 4.4 KB
  - 📄 work_map.py 67.1 KB
- 📁 broker/
  - 📄 session_context.py 11.2 KB
- 📁 fallback_personas/
  - 📄 code-writer.yaml 1.5 KB
  - 📄 debugger.yaml 1.5 KB
- 📁 frontend/
  - 📁 public/
    
    📄 ClaudeVN-Logo-64x64-transparent.png 5.4 KB
    
    📄 ClaudeVN-Logo-64x64.png 7.4 KB
    
    📄 vite.svg 268 B
  - 📁 src/
    
    📁 api/
    
    📄 auth.js 2.2 KB
    
    📄 characterization.js 174 B
    
    📄 compute.js 1.5 KB
    
    📄 decisionTraces.js 995 B
    
    📄 directives.js 1.2 KB
    
    📄 directives.test.js 2.6 KB
    
    📄 goals.js 792 B
    
    📄 index.js 1.1 KB
    
    📄 marketplace.js 838 B
    
    📄 notifications.js 1.6 KB
    
    📄 planSummary.js 298 B
    
    📄 profilePresets.js 951 B
    
    📄 projects.js 2.1 KB
    
    📄 sessions.js 1.2 KB
    
    📄 skills.js 1.9 KB
    
    📄 spawner.js 939 B
    
    📄 sshKeys.js 1.1 KB
    
    📄 sshKeys.test.js 3.8 KB
    
    📄 timing.js 645 B
    
    📄 users.js 1.8 KB
    
    📄 work.js 2.9 KB
    
    📄 workmap.js 6.6 KB
    
    📁 components/
    
    📁 auth/
    
    📄 AuthBadge.jsx 1.4 KB
    
    📄 AuthModal.css 4.5 KB
    
    📄 AuthModal.jsx 7.9 KB
    
    📁 common/
    
    📄 AuthExpiredBanner.css 1.2 KB
    
    📄 AuthExpiredBanner.jsx 1.6 KB
    
    📄 AuthExpiredBanner.test.jsx 863 B
    
    📄 Badge.css 631 B
    
    📄 Badge.jsx 741 B
    
    📄 BucketBadges.css 954 B
    
    📄 BucketBadges.jsx 631 B
    
    📄 BucketBadges.test.jsx 2.7 KB
    
    📄 Card.css 519 B
    
    📄 Card.jsx 452 B
    
    📄 ConfirmDialog.jsx 1.5 KB
    
    📄 EmptyState.css 534 B
    
    📄 EmptyState.jsx 451 B
    
    📄 Modal.css 2.6 KB
    
    📄 Modal.jsx 1.1 KB
    
    📄 Spinner.css 347 B
    
    📄 Spinner.jsx 141 B
    
    📄 Toast.css 1.6 KB
    
    📄 Toast.jsx 1007 B
    
    📁 directives/
    
    📄 Conversation.css 17.7 KB
    
    📄 ConversationInput.jsx 4.0 KB
    
    📄 ConversationInput.test.jsx 8.4 KB
    
    📄 ConversationTimeline.jsx 10.9 KB
    
    📄 ConversationTimeline.test.jsx 13.2 KB
    
    📄 GoalCompletionCard.jsx 2.5 KB
    
    📁 goals/
    
    📄 DeleteGoalConfirmDialog.jsx 4.0 KB
    
    📄 EvaluationStatusIndicator.css 2.5 KB
    
    📄 EvaluationStatusIndicator.jsx 3.0 KB
    
    📄 GoalHistoryPanel.jsx 15.3 KB
    
    📄 GoalHistoryPanel.test.jsx 14.3 KB
    
    📄 GoalProgressBar.css 2.3 KB
    
    📄 GoalProgressBar.jsx 3.8 KB
    
    📄 Goals.css 14.3 KB
    
    📁 health/
    
    📄 HealthPanel.css 4.3 KB
    
    📄 HealthPanel.jsx 3.1 KB
    
    📁 layout/
    
    📄 Sidebar.css 5.2 KB
    
    📄 Sidebar.jsx 6.3 KB
    
    📄 Sidebar.test.jsx 2.6 KB
    
    📁 network/
    
    📄 ApprovalModal.css 3.0 KB
    
    📄 ApprovalModal.jsx 4.5 KB
    
    📄 ApprovalModal.test.jsx 5.1 KB
    
    📄 ComputeCard.jsx 2.6 KB
    
    📄 ComputeDetailModal.jsx 13.3 KB
    
    📄 ComputeList.jsx 4.5 KB
    
    📄 MarketplaceCard.jsx 2.6 KB
    
    📄 MarketplaceDetailModal.jsx 5.9 KB
    
    📄 MarketplaceList.jsx 3.3 KB
    
    📄 Network.css 12.3 KB
    
    📄 NetworkMap.css 7.2 KB
    
    📄 NetworkMap.jsx 23.7 KB
    
    📄 PendingConnections.css 2.4 KB
    
    📄 PendingConnections.jsx 4.9 KB
    
    📄 SkillCard.jsx 2.0 KB
    
    📄 SkillCreateModal.css 4.0 KB
    
    📄 SkillCreateModal.jsx 12.5 KB
    
    📄 SkillDetailModal.jsx 6.3 KB
    
    📄 SkillEditModal.jsx 17.9 KB
    
    📄 SkillList.jsx 9.4 KB
    
    📁 notifications/
    
    📄 NotificationBell.jsx 773 B
    
    📄 Notifications.css 1.1 KB
    
    📁 plan/
    
    📄 ActiveWorkView.jsx 6.1 KB
    
    📄 ActiveWorkView.test.jsx 7.1 KB
    
    📄 CharacterizationBanner.jsx 1.2 KB
    
    📄 DependencyGraphView.jsx 8.0 KB
    
    📄 IssueDependencyGraphView.jsx 1.5 KB
    
    📄 ItemTracesPanel.jsx 4.1 KB
    
    📄 Plan.css 17.3 KB
    
    📄 ProfileSwitcher.css 2.6 KB
    
    📄 ProfileSwitcher.jsx 3.5 KB
    
    📄 SummaryBar.jsx 3.5 KB
    
    📄 SummaryBar.test.jsx 2.5 KB
    
    📄 WhyThisOrder.jsx 7.1 KB
    
    📄 WhyThisOrder.test.jsx 8.6 KB
    
    📁 projects/
    
    📄 DeleteProjectModal.jsx 1.6 KB
    
    📄 ProjectActivity.jsx 5.9 KB
    
    📄 ProjectCard.jsx 5.5 KB
    
    📄 ProjectFilterBar.css 1.7 KB
    
    📄 ProjectFilterBar.jsx 2.3 KB
    
    📄 ProjectFormModal.jsx 14.5 KB
    
    📄 ProjectFormModal.test.jsx 12.4 KB
    
    📄 ProjectList.jsx 1.4 KB
    
    📄 Projects.css 11.8 KB
    
    📄 RepoFormModal.jsx 8.9 KB
    
    📄 RepoList.jsx 8.2 KB
    
    📁 workmap/
    
    📄 ActiveWorkPanel.css 2.4 KB
    
    📄 ActiveWorkPanel.jsx 2.9 KB
    
    📄 IssueDependencyGraph.css 1.9 KB
    
    📄 IssueDependencyGraph.jsx 10.1 KB
    
    📄 IssueDetailModal.css 4.6 KB
    
    📄 IssueDetailModal.jsx 10.0 KB
    
    📄 IssueFormModal.css 2.5 KB
    
    📄 IssueFormModal.jsx 11.1 KB
    
    📄 WorkMapBacklog.css 7.4 KB
    
    📄 WorkMapBacklog.jsx 16.2 KB
    
    📄 WorkMapGraph.css 2.7 KB
    
    📄 WorkMapGraph.jsx 8.4 KB
    
    📄 WorkMapStats.css 2.2 KB
    
    📄 WorkMapStats.jsx 2.6 KB
    
    📁 contexts/
    
    📄 AppContext.jsx 827 B
    
    📄 CognitoAuthContext.jsx 5.8 KB
    
    📄 ProjectContext.jsx 3.3 KB
    
    📄 ToastContext.jsx 1.5 KB
    
    📁 hooks/
    
    📄 useAuth.js 4.2 KB
    
    📄 useAuth.test.js 7.8 KB
    
    📄 useAuthTokens.js 2.3 KB
    
    📄 useBucketTree.js 1.7 KB
    
    📄 useBucketTree.test.js 3.4 KB
    
    📄 useCharacterizationStatuses.js 1.6 KB
    
    📄 useCharacterizationStatuses.test.js 3.2 KB
    
    📄 useCommentStatus.js 2.9 KB
    
    📄 useCompute.js 2.4 KB
    
    📄 useConversation.js 9.4 KB
    
    📄 useConversation.test.js 12.8 KB
    
    📄 useGoals.js 7.5 KB
    
    📄 useGoals.test.js 13.3 KB
    
    📄 useIssues.js 2.3 KB
    
    📄 useItemTraces.js 798 B
    
    📄 useMarketplace.js 1.1 KB
    
    📄 useNetworkCapacity.js 1.4 KB
    
    📄 useNotifications.js 3.2 KB
    
    📄 useObservability.js 2.3 KB
    
    📄 usePlanSummary.js 1.3 KB
    
    📄 usePlanSummary.test.js 4.2 KB
    
    📄 useProjectFilters.js 2.3 KB
    
    📄 useProjects.js 2.2 KB
    
    📄 useSkills.js 1.0 KB
    
    📄 useSSHKeys.js 1.0 KB
    
    📄 useSystemHealth.js 2.8 KB
    
    📄 useTiming.js 1.3 KB
    
    📄 useToast.js 94 B
    
    📄 useUser.js 2.3 KB
    
    📄 useWork.js 2.4 KB
    
    📄 useWorkMap.js 2.3 KB
    
    📁 pages/
    
    📄 AuthSetupPage.css 7.1 KB
    
    📄 AuthSetupPage.jsx 6.7 KB
    
    📄 AuthSetupPage.test.jsx 3.3 KB
    
    📄 BacklogPage.css 15.7 KB
    
    📄 BacklogPage.jsx 32.7 KB
    
    📄 BacklogPage.test.jsx 923 B
    
    📄 ExecutionPlanPage.css 1.3 KB
    
    📄 ExecutionPlanPage.jsx 5.1 KB
    
    📄 ForgotPasswordPage.jsx 5.2 KB
    
    📄 GoalsPage.jsx 13.7 KB
    
    📄 LoginPage.css 2.8 KB
    
    📄 LoginPage.jsx 2.5 KB
    
    📄 NetworkHealthPage.css 6.1 KB
    
    📄 NetworkHealthPage.jsx 8.5 KB
    
    📄 NotificationsPage.css 5.2 KB
    
    📄 NotificationsPage.jsx 7.7 KB
    
    📄 ProfilePage.css 3.4 KB
    
    📄 ProfilePage.jsx 5.7 KB
    
    📄 ProjectsPage.jsx 9.0 KB
    
    📄 SetPasswordPage.jsx 2.9 KB
    
    📄 SettingsPage.css 5.1 KB
    
    📄 SettingsPage.jsx 8.7 KB
    
    📄 SkillsPage.jsx 1.4 KB
    
    📄 SSHKeysPage.css 4.6 KB
    
    📄 SSHKeysPage.jsx 8.3 KB
    
    📄 TimingPage.css 9.1 KB
    
    📄 TimingPage.jsx 17.5 KB
    
    📄 TimingPage.test.jsx 6.3 KB
    
    📄 UserManagementPage.css 4.5 KB
    
    📄 UserManagementPage.jsx 7.1 KB
    
    📁 services/
    
    📄 observabilityWebSocket.js 3.9 KB
    
    📄 App.css 4.4 KB
    
    📄 App.jsx 5.9 KB
    
    📄 main.jsx 319 B
    
    📄 test-setup.js 35 B
  - 📄 .gitignore 253 B
  - 📄 eslint.config.js 736 B
  - 📄 index.html 368 B
  - 📄 package-lock.json 255.5 KB
  - 📄 package.json 830 B
  - 📄 vite.config.js 457 B
- 📁 git/
  - 📁 hooks/
    
    📄 post-receive 3.5 KB
    
    📄 pre-receive 3.7 KB
  - 📄 __init__.py 769 B
  - 📄 git_token_service.py 9.1 KB
  - 📄 http_backend.py 8.0 KB
  - 📄 pr_service.py 45.8 KB
  - 📄 redis_client.py 14.8 KB
  - 📄 repo_manager.py 34.6 KB
  - 📄 ssh_key_service.py 7.0 KB
  - 📄 url_utils.py 3.1 KB
- 📁 mcp/
  - 📁 tools/
    
    📄 __init__.py 586 B
    
    📄 assignment.py 2.3 KB
    
    📄 blocker.py 4.3 KB
    
    📄 challenge.py 6.3 KB
    
    📄 characterization.py 10.3 KB
    
    📄 complete.py 5.9 KB
    
    📄 conflict.py 3.8 KB
    
    📄 context.py 4.1 KB
    
    📄 decomposition.py 8.7 KB
    
    📄 issues.py 4.8 KB
    
    📄 progress.py 2.3 KB
    
    📄 requirement.py 5.7 KB
    
    📄 review.py 2.9 KB
    
    📄 skill.py 1.1 KB
  - 📄 __init__.py 789 B
  - 📄 auth.py 9.7 KB
  - 📄 FILES.txt 3.3 KB
  - 📄 IMPLEMENTATION.md 8.9 KB
  - 📄 manual_mcp_test.py 2.8 KB
  - 📄 models.py 11.9 KB
  - 📄 README.md 7.4 KB
  - 📄 server.py 5.5 KB
  - 📄 stdio_server.py 26.1 KB
- 📁 middleware/
  - 📄 __init__.py 277 B
  - 📄 cognito_auth.py 4.0 KB
  - 📄 cognito_middleware.py 3.7 KB
  - 📄 rate_limiter.py 11.0 KB
- 📁 models/
  - 📄 __init__.py 427 B
  - 📄 auth.py 2.0 KB
  - 📄 characterization.py 12.2 KB
  - 📄 claude_client.py 3.2 KB
  - 📄 compute.py 26.8 KB
  - 📄 compute_spawner.py 4.2 KB
  - 📄 conflict.py 15.5 KB
  - 📄 decision_trace.py 5.7 KB
  - 📄 directive.py 4.9 KB
  - 📄 feedback.py 5.2 KB
  - 📄 goal_decomposer.py 6.1 KB
  - 📄 issue.py 9.0 KB
  - 📄 marketplace.py 7.8 KB
  - 📄 notification.py 1.7 KB
  - 📄 observability.py 22.8 KB
  - 📄 ontology.py 16.2 KB
  - 📄 pipeline.py 7.1 KB
  - 📄 plan_executor.py 4.2 KB
  - 📄 planner_focus.py 5.5 KB
  - 📄 planner_profile.py 12.3 KB
  - 📄 priority_bucket.py 15.8 KB
  - 📄 process_map.py 23.5 KB
  - 📄 project.py 8.4 KB
  - 📄 specialization.py 3.9 KB
  - 📄 timing.py 3.9 KB
  - 📄 unified_directive.py 4.0 KB
  - 📄 user.py 1.9 KB
  - 📄 work_map.py 45.0 KB
  - 📄 work_planner.py 4.9 KB
  - 📄 work_profile_preset.py 11.2 KB
- 📁 scripts/
  - 📄 claude-reauth.sh 718 B
- 📁 services/
  - 📁 providers/
    
    📄 __init__.py 0 B
    
    📄 docker_provisioner.py 7.5 KB
    
    📄 manual_provisioner.py 3.9 KB
  - 📄 __init__.py 433 B
  - 📄 activity_grouping_service.py 8.7 KB
  - 📄 assignment_service.py 36.3 KB
  - 📄 bucket_reorganization_service.py 27.0 KB
  - 📄 bucket_tree_store.py 15.2 KB
  - 📄 characterization_service.py 27.2 KB
  - 📄 claude_auth_service.py 23.1 KB
  - 📄 claude_client.py 11.6 KB
  - 📄 cognito_user_service.py 4.3 KB
  - 📄 comment_rollup_service.py 15.4 KB
  - 📄 completion_events.py 2.9 KB
  - 📄 compute_lifecycle_service.py 7.9 KB
  - 📄 compute_provisioner.py 8.9 KB
  - 📄 compute_spawner.py 28.3 KB
  - 📄 conflict_detection_service.py 40.6 KB
  - 📄 consistency_service.py 12.7 KB
  - 📄 context_affinity_service.py 4.9 KB
  - 📄 coordinating_team_service.py 25.9 KB
  - 📄 decision_trace_service.py 12.5 KB
  - 📄 directive_service.py 27.7 KB
  - 📄 feedback_aggregation_service.py 20.2 KB
  - 📄 goal_comment_service.py 17.1 KB
  - 📄 goal_decomposer.py 25.2 KB
  - 📄 goal_evaluation_service.py 17.9 KB
  - 📄 goal_intent_service.py 12.5 KB
  - 📄 goal_service.py 37.1 KB
  - 📄 health_monitor.py 10.7 KB
  - 📄 issue_evaluation_service.py 17.9 KB
  - 📄 issue_ops_service.py 39.9 KB
  - 📄 issue_service.py 26.1 KB
  - 📄 marketplace_client.py 17.6 KB
  - 📄 marketplace_registry.py 21.1 KB
  - 📄 notification_service.py 5.8 KB
  - 📄 observability_event_bus.py 14.3 KB
  - 📄 pipeline_service.py 14.0 KB
  - 📄 plan_executor.py 16.0 KB
  - 📄 planner_focus_service.py 16.4 KB
  - 📄 planner_profile_service.py 39.8 KB
  - 📄 process_map_service.py 31.1 KB
  - 📄 project_service.py 28.0 KB
  - 📄 reconciliation_manager.py 12.8 KB
  - 📄 registry_service.py 38.2 KB
  - 📄 release_service.py 10.1 KB
  - 📄 repo_sync_service.py 13.5 KB
  - 📄 runtime_inference.py 3.1 KB
  - 📄 skill_selection_service.py 4.4 KB
  - 📄 specialization_service.py 15.0 KB
  - 📄 sse_connection_manager.py 23.2 KB
  - 📄 timing_service.py 25.8 KB
  - 📄 unified_directive_service.py 37.0 KB
  - 📄 user_service.py 9.0 KB
  - 📄 work_dispatcher.py 15.8 KB
  - 📄 work_map_service.py 54.0 KB
  - 📄 work_orchestrator.py 70.7 KB
  - 📄 work_planner.py 40.5 KB
  - 📄 work_scheduler.py 4.2 KB
- 📁 storage/
  - 📄 __init__.py 641 B
  - 📄 cache_backend.py 6.4 KB
  - 📄 data_provider.py 9.5 KB
  - 📄 registry_storage.py 6.4 KB
- 📁 tests/
  - 📁 integration/
    
    📄 test_api_integration.py 41.5 KB
    
    📄 test_e2e_directive_workflow.py 26.1 KB
    
    📄 test_git_clone_lite.py 14.1 KB
    
    📄 test_git_workflow_e2e.py 28.1 KB
    
    📄 test_linked_repo_workflow.py 30.3 KB
    
    📄 test_mcp_tools_integration.py 31.5 KB
    
    📄 test_orchestrator_detection.py 28.4 KB
    
    📄 test_skill_selection_integration.py 27.5 KB
    
    📄 test_work_execution_flow.py 35.4 KB
    
    📄 test_work_timeout_integration.py 22.7 KB
  - 📁 manual/
    
    📄 test_branch_verification.py 7.3 KB
  - 📁 unit/
    
    📄 test_assignment_service.py 32.7 KB
    
    📄 test_auth_api.py 12.2 KB
    
    📄 test_auth_models.py 4.1 KB
    
    📄 test_bucket_reorg_trigger.py 10.5 KB
    
    📄 test_bucket_reorganization_service.py 37.3 KB
    
    📄 test_bucket_tree_execution.py 29.9 KB
    
    📄 test_bucket_tree_planner.py 31.0 KB
    
    📄 test_cache_api.py 5.1 KB
    
    📄 test_cascade_after_merge.py 8.1 KB
    
    📄 test_cascade_delete.py 11.4 KB
    
    📄 test_characterization_api.py 10.6 KB
    
    📄 test_characterization_integration.py 19.7 KB
    
    📄 test_characterization_models.py 11.7 KB
    
    📄 test_characterization_result_endpoint.py 16.5 KB
    
    📄 test_characterization_service.py 20.3 KB
    
    📄 test_claude_auth_service.py 30.1 KB
    
    📄 test_claude_client.py 24.7 KB
    
    📄 test_cognito_auth.py 5.9 KB
    
    📄 test_cognito_config.py 3.5 KB
    
    📄 test_cognito_user_service.py 6.0 KB
    
    📄 test_comment_evaluate_api.py 10.9 KB
    
    📄 test_comment_rollup_service.py 17.0 KB
    
    📄 test_compute_approval.py 5.1 KB
    
    📄 test_compute_auth_status.py 9.2 KB
    
    📄 test_compute_drain.py 15.2 KB
    
    📄 test_compute_event_completion.py 27.9 KB
    
    📄 test_compute_events.py 16.5 KB
    
    📄 test_compute_project_tagging.py 16.8 KB
    
    📄 test_compute_rejection_redispatch.py 15.5 KB
    
    📄 test_compute_spawner.py 46.5 KB
    
    📄 test_config.py 5.8 KB
    
    📄 test_conflict_detection_service.py 26.6 KB
    
    📄 test_conflict_models.py 14.2 KB
    
    📄 test_conflict_resolution_dispatch.py 17.8 KB
    
    📄 test_conflicts_api.py 12.7 KB
    
    📄 test_context_affinity_service.py 25.6 KB
    
    📄 test_create_project_with_repos.py 13.2 KB
    
    📄 test_decision_trace_api.py 8.1 KB
    
    📄 test_decision_trace_integration.py 15.4 KB
    
    📄 test_decision_trace_models.py 8.9 KB
    
    📄 test_decision_trace_service.py 15.4 KB
    
    📄 test_default_branch.py 11.5 KB
    
    📄 test_dependency_resolution.py 29.3 KB
    
    📄 test_deregister_sse_cleanup.py 3.2 KB
    
    📄 test_directive_service.py 17.4 KB
    
    📄 test_error_recovery.py 33.3 KB
    
    📄 test_feedback_aggregation_service.py 24.8 KB
    
    📄 test_feedback_api.py 5.6 KB
    
    📄 test_fleet_credential_management.py 9.8 KB
    
    📄 test_git_api_branch_deletion.py 5.4 KB
    
    📄 test_git_api_hooks.py 10.1 KB
    
    📄 test_git_http_backend.py 21.3 KB
    
    📄 test_git_token_service.py 19.1 KB
    
    📄 test_goal_comment_service.py 18.6 KB
    
    📄 test_goal_decomposer.py 29.9 KB
    
    📄 test_goal_dedup.py 6.9 KB
    
    📄 test_goal_evaluation_service.py 18.1 KB
    
    📄 test_goal_indicators.py 13.3 KB
    
    📄 test_goal_intent_integration.py 14.5 KB
    
    📄 test_goal_intent_service.py 14.3 KB
    
    📄 test_goal_planning_timeout.py 26.8 KB
    
    📄 test_goal_progress.py 15.2 KB
    
    📄 test_goal_project_context.py 7.7 KB
    
    📄 test_goal_service.py 27.1 KB
    
    📄 test_health_monitor.py 15.0 KB
    
    📄 test_hook_dynamic_default_branch.py 11.7 KB
    
    📄 test_initial_bucket_tree.py 15.7 KB
    
    📄 test_internal_repo.py 14.3 KB
    
    📄 test_issue_evaluation_service.py 31.8 KB
    
    📄 test_issue_ontology_integration.py 16.0 KB
    
    📄 test_issue_ops_project_filter.py 12.3 KB
    
    📄 test_issue_service.py 35.6 KB
    
    📄 test_issue_work_bridge.py 26.6 KB
    
    📄 test_marketplace_client.py 27.0 KB
    
    📄 test_marketplace_registry.py 30.2 KB
    
    📄 test_mcp_add_issues.py 20.0 KB
    
    📄 test_mcp_assignment.py 9.5 KB
    
    📄 test_mcp_auth.py 17.4 KB
    
    📄 test_mcp_blocker.py 13.6 KB
    
    📄 test_mcp_challenge.py 20.8 KB
    
    📄 test_mcp_characterization.py 13.2 KB
    
    📄 test_mcp_complete_task.py 11.3 KB
    
    📄 test_mcp_conflict.py 7.6 KB
    
    📄 test_mcp_context.py 14.5 KB
    
    📄 test_mcp_decomposition_idempotent.py 4.1 KB
    
    📄 test_mcp_progress.py 13.0 KB
    
    📄 test_mcp_requirement.py 18.9 KB
    
    📄 test_mcp_review.py 14.4 KB
    
    📄 test_mcp_skill.py 9.6 KB
    
    📄 test_mcp_stdio_server.py 10.7 KB
    
    📄 test_merge_conflict_pipeline.py 15.1 KB
    
    📄 test_models.py 5.2 KB
    
    📄 test_multi_compute_coordination.py 33.1 KB
    
    📄 test_multi_goal_reconciliation.py 28.3 KB
    
    📄 test_network_capacity.py 6.8 KB
    
    📄 test_notification_api.py 6.6 KB
    
    📄 test_notification_service.py 7.5 KB
    
    📄 test_observability_event_bus.py 4.8 KB
    
    📄 test_observability_models.py 7.7 KB
    
    📄 test_ontology_models.py 11.6 KB
    
    📄 test_orchestrator_spawn_integration.py 29.7 KB
    
    📄 test_ownership_model.py 4.6 KB
    
    📄 test_pending_status.py 7.2 KB
    
    📄 test_plan_executor.py 27.8 KB
    
    📄 test_plan_summary_api.py 13.2 KB
    
    📄 test_planner_focus_service.py 18.8 KB
    
    📄 test_planner_profile.py 18.9 KB
    
    📄 test_planner_profile_intent.py 11.6 KB
    
    📄 test_planner_profile_service.py 30.9 KB
    
    📄 test_pr_service.py 37.3 KB
    
    📄 test_pr_service_merge.py 50.1 KB
    
    📄 test_pre_receive_hook_logic.py 8.5 KB
    
    📄 test_priority_bucket.py 26.3 KB
    
    📄 test_project_models.py 18.8 KB
    
    📄 test_project_service.py 59.9 KB
    
    📄 test_projects_api_description.py 4.0 KB
    
    📄 test_rate_limiter.py 13.6 KB
    
    📄 test_reconnect_after_restart.py 12.5 KB
    
    📄 test_redis_health.py 4.7 KB
    
    📄 test_redis_set_operations.py 10.2 KB
    
    📄 test_registration_approval.py 9.6 KB
    
    📄 test_registry_service.py 22.1 KB
    
    📄 test_registry_storage.py 4.6 KB
    
    📄 test_release_service.py 21.4 KB
    
    📄 test_repo_details_in_assignments.py 13.4 KB
    
    📄 test_repo_manager_clone.py 10.9 KB
    
    📄 test_repo_manager_hooks.py 7.6 KB
    
    📄 test_repo_manager_pull.py 5.8 KB
    
    📄 test_repo_manager_seed_commit.py 5.2 KB
    
    📄 test_repo_manager_worktree.py 11.3 KB
    
    📄 test_repo_sync.py 8.1 KB
    
    📄 test_serving_self_auth.py 8.0 KB
    
    📄 test_skill_selection_service.py 13.1 KB
    
    📄 test_skills_api.py 15.0 KB
    
    📄 test_slim_claude_code_api.py 60.7 KB
    
    📄 test_specialization_integration.py 7.3 KB
    
    📄 test_specialization_service.py 16.9 KB
    
    📄 test_sse_compute.py 14.7 KB
    
    📄 test_sse_connection_manager.py 35.9 KB
    
    📄 test_ssh_key_api.py 6.0 KB
    
    📄 test_ssh_key_service.py 8.5 KB
    
    📄 test_supplemental_decomposition.py 27.7 KB
    
    📄 test_timing_models.py 3.9 KB
    
    📄 test_timing_service.py 10.7 KB
    
    📄 test_unified_directive_service.py 59.4 KB
    
    📄 test_unified_directives_api.py 8.1 KB
    
    📄 test_user_service.py 5.8 KB
    
    📄 test_users_api.py 4.2 KB
    
    📄 test_work_dispatcher.py 18.9 KB
    
    📄 test_work_failure_notifications.py 12.2 KB
    
    📄 test_work_map_dependencies_bulk.py 5.3 KB
    
    📄 test_work_map_models.py 24.1 KB
    
    📄 test_work_map_service.py 44.5 KB
    
    📄 test_work_orchestrator.py 95.7 KB
    
    📄 test_work_orchestrator_circuit_breaker.py 15.5 KB
    
    📄 test_work_planner.py 33.8 KB
    
    📄 test_work_profile_presets.py 12.6 KB
    
    📄 test_workmap_api_bucket_tree.py 7.2 KB
    
    📄 test_workmap_api_project_scoping.py 11.5 KB
    
    📄 test_workmap_goals_issues.py 26.3 KB
    
    📄 test_workmap_redis_indexes.py 17.6 KB
  - 📄 __init__.py 40 B
  - 📄 conftest.py 430 B
  - 📄 test_add_repo_auto_clone.py 7.0 KB
  - 📄 test_capability_gap_detection.py 14.5 KB
  - 📄 test_capability_labeling.py 6.7 KB
  - 📄 test_compute_deregister_key_revocation.py 2.9 KB
  - 📄 test_compute_lifecycle_service.py 11.0 KB
  - 📄 test_compute_provisioner.py 6.4 KB
  - 📄 test_docker_provisioner.py 9.2 KB
  - 📄 test_goal_summary.py 9.9 KB
  - 📄 test_lifecycle_mode.py 2.9 KB
  - 📄 test_manual_provisioner.py 5.4 KB
  - 📄 test_marketplace_tier.py 4.5 KB
  - 📄 test_model_selection.py 5.8 KB
  - 📄 test_node_compute_image.py 2.3 KB
  - 📄 test_pr_service_inter_merge_sync.py 4.9 KB
  - 📄 test_pr_service_push_upstream.py 4.1 KB
  - 📄 test_pr_service_upstream_sync.py 7.5 KB
  - 📄 test_pr_service_url_migration.py 8.5 KB
  - 📄 test_priority_bucket.py 4.0 KB
  - 📄 test_project_filtering.py 9.3 KB
  - 📄 test_project_models.py 8.5 KB
  - 📄 test_runtime_inference.py 8.1 KB
  - 📄 test_serving_public_url_validation.py 2.9 KB
  - 📄 test_skills_api.py 3.9 KB
  - 📄 test_sse_force_reconnect.py 3.3 KB
  - 📄 test_sse_heartbeat_reconciliation.py 4.1 KB
  - 📄 test_timing_lineage.py 9.6 KB
  - 📄 test_timing_service.py 16.5 KB
  - 📄 test_url_utils.py 5.5 KB
  - 📄 test_work_map_filters.py 7.2 KB
  - 📄 test_work_orchestrator_sync.py 6.9 KB
- 📄 .env.example 4.5 KB
- 📄 .gitignore 348 B
- 📄 app.py 60.6 KB
- 📄 AUDIT_REPORT.md 5.7 KB
- 📄 config.py 15.6 KB
- 📄 Dockerfile 2.7 KB
- 📄 README.md 22.3 KB
- 📄 requirements.txt 729 B
- 📄 start.sh 2.9 KB
- 📄 stop.sh 1.5 KB
- 📄 STORAGE.md 9.7 KB
📁 shared/
- 📁 claudevn_shared/
  - 📄 __init__.py 187 B
  - 📄 llm_types.py 2.0 KB
  - 📄 version.py 1.8 KB
- 📁 tests/
  - 📄 test_version.py 3.8 KB
- 📄 .gitignore 135 B
- 📄 README.md 749 B
- 📄 setup.py 570 B
📁 tests/
- 📄 test_system_integration.py 17.6 KB
- 📄 test_user_scenarios.py 26.2 KB
📄 .dockerignore 830 B
📄 .env.compute.example 6.6 KB
📄 .env.example 4.5 KB
📄 .env.serving.example 3.3 KB
📄 .gitignore 2.2 KB
📄 architecture.png 1.2 MB
📄 CLA.md 5.2 KB
📄 CLAUDE.md 5.4 KB
📄 CODE_OF_CONDUCT.md 2.3 KB
📄 conftest.py 268 B
📄 CONTRIBUTING.md 6.2 KB
📄 docker-compose.compute.yml 3.0 KB
📄 docker-compose.marketplace.yml 2.3 KB
📄 docker-compose.override.example.yml 417 B
📄 docker-compose.serving.yml 4.7 KB
📄 docker-compose.test.yml 613 B
📄 docker-compose.yml 11.5 KB
📄 docker.env.example 1.8 KB
📄 LICENSE 34.6 KB
📄 MARKETPLACE_EXTRACTION.md 13.1 KB
📄 pytest.ini 208 B
📄 README.md 10.6 KB
📄 SECURITY.md 734 B
📄 SKILL.md 7.2 KB
📄 THIRD_PARTY_NOTICES.md 4.9 KB
📄 VERSION 6 B

SKILL.md

---
name: claudevn-patterns
description: Coding patterns extracted from ClaudeVN AI agent orchestration platform
version: 1.0.0
source: local-git-analysis
analyzed_commits: 200
---

# ClaudeVN Development Patterns

## Commit Conventions

This project uses **conventional commits** with issue references:

| Prefix | Usage |
|--------|-------|
| `feat:` | New features (59% of commits) |
| `fix:` | Bug fixes (20% of commits) |
| `docs:` | Documentation updates (9%) |
| `test:` | Test-related changes (8%) |
| `refactor:` | Code restructuring (2%) |
| `chore:` | Maintenance tasks (2%) |

**Commit message format:**
```
feat: Short description of feature (#issue-number)
fix: Brief bug fix description (#issue-number)
docs: Documentation update description
```

**73% of commits reference GitHub issues** - always link commits to issues.

**Branch naming convention:**
```
{type}/issue-{number}-{short-description}
```

Examples:
- `feat/issue-155-shutdown-handler`
- `fix/issue-102-failing-unit-tests`
- `docs/issue-149-goal-api-endpoints`

## Code Architecture

### Directory Structure

```
serving/              # Central coordination hub (FastAPI, Python 3.10+)
├── api/              # API route handlers (one file per domain)
├── models/           # Pydantic data models
├── services/         # Business logic services
├── git/              # Git infrastructure (SSH, hooks, PR management)
├── mcp/              # MCP server for compute communication
│   └── tools/        # MCP tool implementations
├── tests/            # Unit and integration tests
└── frontend/         # React UI with TailwindCSS
    └── src/
        ├── api/          # API client functions
        ├── components/   # React components by domain
        ├── hooks/        # Custom React hooks
        └── pages/        # Page-level components

marketplace/          # Skill marketplace service (separate from Serving)
├── skills/           # Skill definitions (YAML)
│   └── system/       # System-provided skills
├── personas/         # Persona bundles (YAML)
│   └── system/       # System personas
├── services/         # Business logic
└── tests/            # Test files

compute/              # Claude Code compute infrastructure
├── api/              # API endpoints
├── services/         # Service layer
└── tests/            # Test files
```

### File Naming Conventions

| Type | Pattern | Example |
|------|---------|---------|
| API routes | `{domain}.py` | `serving/api/work_map.py` |
| Models | `{domain}.py` | `serving/models/compute.py` |
| Services | `{domain}_service.py` | `serving/services/work_map_service.py` |
| Tests | `test_{module}.py` | `serving/tests/test_work_map_service.py` |
| React components | `{ComponentName}.jsx` | `WorkMapGraph.jsx` |
| React hooks | `use{HookName}.js` | `useWorkMap.js` |
| API clients | `{domain}.js` | `api/workmap.js` |
| Skills | `{skill-name}.yaml` | `skills/system/code-writer.yaml` |

### Most Frequently Changed Files

1. `serving/app.py` - Main FastAPI application
2. `serving/services/work_map_service.py` - Work coordination logic
3. `serving/models/work_map.py` - Work map data models
4. `CLAUDE.md` - Project instructions for Claude Code
5. `marketplace/api.py` - Marketplace API routes

## Workflows

### Adding a New API Endpoint

1. Create/update model in `serving/models/{domain}.py`
2. Add business logic in `serving/services/{domain}_service.py`
3. Create API route in `serving/api/{domain}.py`
4. Register route in `serving/app.py`
5. Add tests in `serving/tests/test_{domain}_{feature}.py`
6. Update frontend API client if needed

### Adding a New Skill

1. Create YAML definition in `marketplace/skills/system/{skill-name}.yaml`
2. Include: id, name, description, version, author, instructions, tags
3. Add test coverage in `marketplace/tests/test_skill_registry.py`
4. Skills should follow the code-writer.yaml template structure

### Adding a New MCP Tool

1. Create tool in `serving/mcp/tools/{tool_name}.py`
2. Register in `serving/mcp/tools/__init__.py`
3. Add models in `serving/mcp/models.py`
4. Register in `serving/mcp/server.py`
5. Add tests in `serving/tests/test_mcp_{tool_name}.py`

### Adding a Frontend Feature

1. Create component in `serving/frontend/src/components/{domain}/`
2. Add CSS file `{ComponentName}.css` alongside component
3. Create hook in `serving/frontend/src/hooks/use{Feature}.js`
4. Add API client in `serving/frontend/src/api/{domain}.js`
5. Update page in `serving/frontend/src/pages/{Page}Page.jsx`
6. Register route in `serving/frontend/src/App.jsx` if new page

## Testing Patterns

### Test Structure

```python
"""Tests for {module}."""

import pytest
from unittest.mock import AsyncMock, MagicMock, patch

# Fixtures
@pytest.fixture
def mock_redis():
    """Create mock Redis client."""
    redis = MagicMock()
    redis._redis = MagicMock()
    redis._redis.hset = AsyncMock()
    return redis

@pytest.fixture
def service():
    """Create service for testing."""
    return MyService(redis_client=None)

# Test Classes grouped by functionality
class TestServiceInit:
    """Test service initialization."""

    def test_init_without_deps(self):
        """Test initialization without dependencies."""
        pass

    @pytest.mark.asyncio
    async def test_async_operation(self):
        """Test async operations."""
        pass
```

### Test File Organization

- Unit tests: `{component}/tests/test_{module}.py`
- Integration tests: `tests/test_{integration_type}.py`
- Run unit tests: `scripts/run_unit_tests.sh`
- Run integration tests: `scripts/run_integration_tests.sh`

### Test Naming

- Test files: `test_{module_name}.py`
- Test classes: `Test{FeatureName}` (e.g., `TestWorkMapServiceInit`)
- Test methods: `test_{action}_{scenario}` (e.g., `test_init_without_redis`)

## Code Quality

### Python Standards

- Use Pydantic v2 `model_config` (not deprecated `class Config`)
- Use `datetime.now(timezone.utc)` (not deprecated `datetime.utcnow()`)
- Type hints on all function signatures
- Docstrings for modules, classes, and public methods
- AsyncMock for async method mocking

### Pull Request Requirements

1. All changes go through Pull Requests (never push directly to main)
2. Branch naming: `{type}/issue-{number}-{description}`
3. Reference issue in commit message: `feat: Description (#123)`
4. Tests must pass before merge
5. Only Serving can merge to main

### Git Hooks

- Pre-receive: Validates branch naming (`{type}/issue-{number}-...`)
- Post-receive: Updates PR queue status in Redis
- Branch protection: Compute instances can only push their own branches

## Domain-Specific Patterns

### Work Coordination

- WorkMap tracks goals and issues with dependencies
- Redis used for indexes and status tracking
- Git branches for state management (1 branch = 1 work unit)
- SSE for real-time event streaming

### Skill System

- Skills are YAML files with instructions for Claude Code
- Personas are pre-bundled skill combinations
- Marketplace is a separate service (port 8003)
- Skills compose via simple concatenation

### Compute Communication

- MCP tools for compute-to-serving communication
- SSE for serving-to-compute events
- Git worktrees for parallel branch access
- Registration via SSE connection

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

claudevn-patterns

Directory Structure

SKILL.md

Report

Notice