Implements deterministic feature lifecycle management for agent-driven
development. Agents use the CLI in pods; operators control via REST API.
Library (internal/sdlc/):
- Feature lifecycle with 10 phases (draft → released)
- Classifier engine with priority-ordered rules
- Artifact tracking with approval workflow
- Task management within features
- YAML-based state persistence
CLI (cmd/sdlc/):
- init, state, next, feature, artifact, task, query commands
- --json flag for machine-readable output
- Runs inside project pods
API (21 endpoints under /projects/{id}/sdlc/):
- State: GET /state, GET /next
- Features: CRUD + transition/block/unblock
- Artifacts: approve/reject per type
- Tasks: add/start/complete/block
- Queries: blocked/ready/needs-approval
Architecture:
- Port: SDLCExecutor interface (internal/port/)
- Adapter: kubectl exec into pods (internal/adapter/kubernetes/)
- Service: pod resolution + logging (internal/service/)
- Handlers: 5 files under 500-line limit (internal/handlers/)
Also includes template upgrades (chassis framework, UI components,
OpenAPI helpers, backend/frontend guides) and component improvements.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
AI Lookup Index
Quick reference for rdev concepts and facts.
| Topic | File | Confidence | Updated | Summary |
|---|---|---|---|---|
| Architecture | ||||
| Hexagonal Architecture | patterns/hexagonal.md | High | 2025-01 | Ports/adapters pattern, layer separation |
| Core Services | ||||
| Project Service | services/project-service.md | High | 2025-01 | Business logic for project operations |
| API Keys | services/api-keys.md | High | 2025-01 | Authentication, scopes, restrictions |
| Webhooks | services/webhooks.md | High | 2025-01 | Event subscriptions and delivery |
| Worker Infrastructure | ||||
| Work Queue | services/work-queue.md | High | 2025-01 | Task queue for worker pool |
| Worker Pool | services/worker-pool.md | High | 2026-01 | Embedded work executor with queue maintenance and metrics |
| CI Provider | services/ci-provider.md | High | 2025-01 | Woodpecker auto-activation |
| DNS / Cloudflare | services/dns-cloudflare.md | High | 2026-01 | Domain management for threesix.ai |
| Template Provider | services/template-provider.md | High | 2025-01 | Project template seeding |
| Features | ||||
| Command Execution | features/command-execution.md | High | 2025-01 | Claude/shell/git command flow |
| SSE Streaming | features/sse-streaming.md | High | 2025-01 | Real-time output streaming |
| Infrastructure Management | features/infrastructure.md | High | 2025-01 | Gitea, Cloudflare, deployment |
| Build Orchestration | features/build-orchestration.md | High | 2026-01 | Bot-driven build specs with audit trail |
| Composable Monorepo | features/composable-monorepo.md | High | 2026-01 | Monorepo skeleton + component templates |
| SDLC | ||||
| SDLC Orchestration | services/sdlc.md | High | 2026-02 | Feature lifecycle, classifier engine, rdev API integration |
Roadmap Reference
See k3s-fleet/tmp/address-the-gaps.md for the full threesix.ai platform roadmap:
- Gap 1: Woodpecker Auto-Activation → CI Provider
- Gap 2: Project Templates → Template Provider
- Gap 3: Work Queue → Work Queue service
- Gap 4: Worker Pool Management → Worker Pool
- Gap 5: Bot Communication → Webhook callbacks
- Gap 6: Build Orchestration → Build service