rrce-workflow 0.1.0

package/agent-core/templates/executor_output.md

@@ -0,0 +1,41 @@
+# Execution Log – {{task_title}}
+
+- Task ID: `{{task_id}}`
+- Task Slug: `{{task_slug}}`
+- Executor: `{{author}}`
+- Date: `{{date}}`
+- Plan Artifact: `{{plan_artifact}}`
+- Branch / Commit Reference: `{{git_ref}}`
+- Workspace: `{{workspace_name}}`
+
+## 1. Work Summary
+- Brief narrative of what was completed.
+- Note any deviations from the plan and why.
+
+## Checklist
+- [ ] Replace with implementation task item.
+- [ ] Replace with verification checkpoint.
+
+## 2. Implementation Steps
+| Step | Description | Status | Evidence / Links |
+| --- | --- | --- | --- |
+| 1 |  | pending |  |
+
+## 3. Testing & Verification
+- Commands executed (summaries only) and outcomes.
+- Coverage of automated and manual checks.
+- Outstanding testing gaps, if any.
+
+## 4. Issues & Follow-ups
+- Bugs discovered, blocked tasks, escalations.
+- Required clarifications for future cycles.
+
+## 5. Deliverables
+- Key files, PRs, or artifacts delivered.
+- Documentation or knowledge updates triggered.
+
+## 6. Next Actions
+- Items remaining before handoff or release.
+- Recommendations for the Documentation agent.
+
+> Keep this log under 500 lines. Inline only the essential evidence; link to detailed outputs when needed.

package/agent-core/templates/init_output.md

@@ -0,0 +1,263 @@
+# Project Context – {{project_name}}
+
+- Initialized: `{{date}}`
+- Last Updated: `{{date}}`
+- Author: `{{author}}`
+- Workspace: `{{workspace_root}}`
+
+---
+
+## 1. Project Identity
+
+| Attribute | Value |
+|-----------|-------|
+| **Name** |  |
+| **Description** |  |
+| **Primary Language(s)** |  |
+| **Runtime Version(s)** |  |
+| **Repository Type** | monorepo / single-app / library |
+| **License** |  |
+
+### Key Documentation
+- README: 
+- CONTRIBUTING: 
+- Other: 
+
+---
+
+## 2. Tech Stack
+
+### Languages & Runtimes
+| Language | Version | Purpose |
+|----------|---------|---------|
+|  |  |  |
+
+### Frameworks
+| Framework | Version | Layer |
+|-----------|---------|-------|
+|  |  | frontend / backend / cli / mobile |
+
+### Databases & Storage
+| Technology | Purpose |
+|------------|---------|
+|  |  |
+
+### External Services & APIs
+| Service | Purpose | Auth Method |
+|---------|---------|-------------|
+|  |  |  |
+
+### Build Tools
+| Tool | Config File | Purpose |
+|------|-------------|---------|
+|  |  |  |
+
+---
+
+## 3. Code Organization
+
+### Directory Structure
+```
+{{workspace_root}}/
+├── 
+├── 
+└── 
+```
+
+### Structure Pattern
+- [ ] Monorepo (multiple packages/services)
+- [ ] Modular (feature-based organization)
+- [ ] Layered (controllers/services/repositories)
+- [ ] Flat (minimal nesting)
+- [ ] Other: 
+
+### Key Directories
+| Directory | Purpose |
+|-----------|---------|
+| `src/` |  |
+| `tests/` |  |
+| `docs/` |  |
+
+### Entry Points
+| File | Purpose |
+|------|---------|
+|  |  |
+
+---
+
+## 4. Coding Conventions
+
+### Style & Formatting
+| Tool | Config File | Key Rules |
+|------|-------------|-----------|
+| Linter |  |  |
+| Formatter |  |  |
+| Type Checker |  |  |
+
+### Naming Conventions
+| Element | Convention | Example |
+|---------|------------|---------|
+| Files |  |  |
+| Functions |  |  |
+| Classes |  |  |
+| Variables |  |  |
+| Constants |  |  |
+
+### Patterns Observed
+- **Error Handling**: 
+- **State Management**: 
+- **Async Patterns**: 
+- **Logging**: 
+- **Configuration**: 
+
+### Code Quality Gates
+- [ ] Type checking enforced
+- [ ] Lint checks in CI
+- [ ] Code review required
+- [ ] Commit message conventions
+
+---
+
+## 5. Testing Strategy
+
+### Test Frameworks
+| Framework | Purpose | Config |
+|-----------|---------|--------|
+|  | unit |  |
+|  | integration |  |
+|  | e2e |  |
+
+### Test Organization
+- [ ] Co-located with source (`*.test.ts` next to `*.ts`)
+- [ ] Separate `tests/` directory
+- [ ] Separate `__tests__/` directories
+- [ ] Other: 
+
+### Coverage Requirements
+| Metric | Target | Current |
+|--------|--------|---------|
+| Line Coverage |  |  |
+| Branch Coverage |  |  |
+
+### Test Commands
+```bash
+# Unit tests
+{{test_unit_command}}
+
+# Integration tests
+{{test_integration_command}}
+
+# E2E tests
+{{test_e2e_command}}
+
+# Coverage report
+{{coverage_command}}
+```
+
+---
+
+## 6. DevOps & Deployment
+
+### CI/CD
+| Platform | Config File | Triggers |
+|----------|-------------|----------|
+|  |  |  |
+
+### Containerization
+| Tool | Config File | Purpose |
+|------|-------------|---------|
+| Docker |  |  |
+| Compose |  |  |
+
+### Environments
+| Environment | URL/Access | Notes |
+|-------------|------------|-------|
+| Development |  |  |
+| Staging |  |  |
+| Production |  |  |
+
+### Infrastructure
+| Tool | Purpose |
+|------|---------|
+|  |  |
+
+---
+
+## 7. Dependencies & Constraints
+
+### Key Dependencies
+| Dependency | Version | Purpose | Critical? |
+|------------|---------|---------|-----------|
+|  |  |  | yes/no |
+
+### Version Strategy
+- [ ] Exact versions pinned
+- [ ] Semver ranges allowed
+- [ ] Lock file committed
+- [ ] Regular dependency updates
+
+### Constraints & Requirements
+- **Node/Runtime Version**: 
+- **OS Compatibility**: 
+- **Browser Support**: 
+- **Security Requirements**: 
+- **Performance Targets**: 
+
+---
+
+## 8. Skill Requirements (Executor Scope)
+
+Based on the tech stack analysis, the Executor agent should have proficiency in:
+
+### Required Skills
+- [ ] 
+- [ ] 
+- [ ] 
+
+### Preferred Skills
+- [ ] 
+- [ ] 
+
+### Out of Scope
+- 
+- 
+
+---
+
+## 9. Project Scope (Research Boundaries)
+
+### In Scope for Research
+- 
+- 
+
+### Out of Scope
+- 
+- 
+
+### Key Stakeholders
+| Role | Responsibility |
+|------|----------------|
+|  |  |
+
+---
+
+## 10. Open Questions & Gaps
+
+| Question | Priority | Notes |
+|----------|----------|-------|
+|  | high/medium/low |  |
+
+---
+
+## Checklist
+
+- [ ] Tech stack fully documented
+- [ ] Coding conventions captured
+- [ ] Testing strategy clear
+- [ ] DevOps pipeline understood
+- [ ] Skill requirements defined
+- [ ] Scope boundaries established
+
+---
+
+> Keep this document under 500 lines. Update when major changes occur. Run `rrce-workflow sync` periodically to reconcile with codebase changes.

package/agent-core/templates/meta.template.json

@@ -0,0 +1,54 @@
+{
+  "task_id": "",
+  "task_slug": "",
+  "title": "",
+  "status": "draft",
+  "summary": "",
+  "workspace": {
+    "name": "",
+    "path": "",
+    "hash": ""
+  },
+  "created_at": "",
+  "updated_at": "",
+  "tags": [],
+  "checklist": [
+    {
+      "id": "",
+      "label": "",
+      "status": "pending",
+      "owner": "",
+      "notes": ""
+    }
+  ],
+  "references": [],
+  "open_questions": [],
+  "decisions": [],
+  "milestones": [],
+  "agents": {
+    "research": {
+      "owner": "",
+      "status": "pending",
+      "artifact": "",
+      "notes": ""
+    },
+    "planning": {
+      "owner": "",
+      "status": "pending",
+      "artifact": "",
+      "notes": ""
+    },
+    "executor": {
+      "owner": "",
+      "status": "pending",
+      "artifact": "",
+      "notes": ""
+    },
+    "documentation": {
+      "owner": "",
+      "status": "pending",
+      "artifact": "",
+      "notes": ""
+    }
+  }
+}

package/agent-core/templates/planning_output.md

@@ -0,0 +1,44 @@
+# Execution Plan – {{task_title}}
+
+- Task ID: `{{task_id}}`
+- Task Slug: `{{task_slug}}`
+- Planner: `{{author}}`
+- Date: `{{date}}`
+- Research Artifact: `{{research_artifact}}`
+- Workspace: `{{workspace_name}}`
+
+## 1. Scope Confirmation
+- Summary of the agreed requirements.
+- Explicit inclusions / exclusions.
+
+## Checklist
+- [ ] Replace with planned deliverable checkpoint.
+- [ ] Replace with verification gate.
+
+## 2. Objectives & Success Criteria
+- Primary outcomes to deliver.
+- Quantifiable acceptance checks or KPIs.
+
+## 3. Task Breakdown
+| Order | Task | Owner | Acceptance Criteria | Dependencies | Est. Effort |
+| --- | --- | --- | --- | --- | --- |
+| 1 |  |  |  |  |  |
+
+## 4. Risks & Mitigations
+- Top risks with mitigation or contingency.
+- Blockers requiring external support.
+
+## 5. Validation Strategy
+- Tests to run (unit/integration/e2e/manual).
+- Tooling or environments needed.
+
+## 6. Knowledge & Asset Updates
+- Files in `{{RRCE_DATA}}/knowledge` to create or update, with reasoning.
+- Additional references or diagrams to produce.
+
+## 7. Handoff Checklist
+- Prerequisites for the Executor (branches, feature flags, data, etc.).
+- Metrics or telemetry to monitor during implementation.
+- Open questions carried forward (also logged in `meta.json`).
+
+> Keep this plan under 500 lines. Remove unused rows or sections once populated.

package/agent-core/templates/research_output.md

@@ -0,0 +1,44 @@
+# Research Brief – {{task_title}}
+
+- Task ID: `{{task_id}}`
+- Task Slug: `{{task_slug}}`
+- Author: `{{author}}`
+- Date: `{{date}}`
+- Source Request / Conversation URL: `{{source}}`
+- Workspace: `{{workspace_name}}`
+
+## 1. Request Summary
+- Concise restatement of the user's ask.
+- Highlight explicit goals, constraints, and success metrics.
+
+## Checklist
+- [ ] Replace with concrete clarification or validation step.
+- [ ] Replace with next ready-to-run action.
+
+## 2. Current Knowledge Snapshot
+- Relevant prior work or documents from `{{RRCE_DATA}}/knowledge` or workspace.
+- Key facts that shape feasibility or scope.
+
+## 3. Clarifications & Responses
+| Question | Answer | Status (answered/pending) | Reference |
+| --- | --- | --- | --- |
+|  |  |  |  |
+
+## 4. Assumptions & Risks
+- Explicit assumptions that require validation.
+- Risks or edge cases that need attention.
+
+## 5. Opportunity & Alternative Approaches
+- Potential strategies worth evaluating.
+- Trade-offs or spikes recommended before execution.
+
+## 6. Raw Requirement Draft
+- Bullet the functional outcomes and non-functional requirements as currently understood.
+- Note acceptance signals or metrics where available.
+
+## 7. Hand-off Notes
+- Immediate next steps for Planning.
+- Pending clarifications or decisions to resolve.
+- References added to `meta.json`.
+
+> Keep this document under 500 lines. Replace placeholders with concise entries and trim empty sections if unnecessary.

package/bin/rrce-workflow.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import "../src/index.tsx";