@tudeorangbiasa/sdd-multiagent-opencode 0.1.0

package/.sdd/templates/spec-compact.md

@@ -0,0 +1,71 @@
+# Specification: [Feature Name]
+
+**Task ID:** [task-id]
+**Created:** [date]
+**Status:** Ready for Planning
+**Version:** 1.0
+
+## 1. Problem Statement
+- The Problem: [Clear description]
+- Current Situation: [How users currently handle this]
+- Desired Outcome: [What success looks like]
+
+## 2. User Personas
+### Primary User: [Name]
+- Who: [Description]
+- Goals: [What they want to achieve]
+- Pain points: [Current frustrations]
+
+## 3. Functional Requirements
+### FR-1: [Requirement Name]
+**Description:** [What it does]
+
+**User Story:**
+> As a [user type], I want to [action] so that [benefit].
+
+**Acceptance Criteria:**
+- [ ] Given [context], when [action], then [result]
+- [ ] [Additional criteria]
+
+**Priority:** Must Have / Should Have / Nice to Have
+
+## 4. Non-Functional Requirements
+- Performance: [Specific metrics]
+- Security: [Security requirements]
+- Accessibility: [Accessibility requirements]
+- Scalability: [Scalability requirements]
+
+## 5. Out of Scope
+- ❌ [Exclusion 1] - [Why excluded]
+- ❌ [Exclusion 2] - [Why excluded]
+
+## 6. Edge Cases & Error Handling
+| Scenario | Expected Behavior |
+|----------|-------------------|
+| [Edge case] | [How system handles] |
+
+| Error | User Message | System Action |
+|-------|--------------|---------------|
+| [Error] | "[Message]" | [Action] |
+
+## 7. Success Metrics
+| Metric | Target | How to Measure |
+|--------|--------|----------------|
+| [Metric] | [Target] | [Method] |
+
+## 8. Open Questions
+- [ ] [Question requiring input]
+
+## 9. Revision History
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0 | [date] | Initial specification |
+
+## Next Steps
+1. Review spec with stakeholders
+2. Resolve open questions
+3. Run `/plan [task-id]` to create technical plan
+
+---
+
+*Specification created with SDD Multi-Agent OpenCode*

package/.sdd/templates/tasks-compact.md

@@ -0,0 +1,48 @@
+# Implementation Tasks: [Feature Name]
+
+**Task ID:** [task-id]
+**Created:** [date]
+**Status:** Ready for Implementation
+
+## Summary
+
+| Metric | Value |
+|--------|-------|
+| Total Tasks | [count] |
+| Estimated Effort | [hours/days] |
+| Phases | [count] |
+
+## Phase 1: [Phase Name]
+
+**Goal:** [What this phase accomplishes]
+
+### Task 1.1: [Task Title]
+
+**Description:** [What needs to be done]
+
+**Acceptance Criteria:**
+- [ ] [Criteria 1]
+- [ ] [Criteria 2]
+
+**Effort:** [X hours]
+**Priority:** High/Medium/Low
+**Dependencies:** None / [Task IDs]
+
+---
+
+[Repeat for all tasks in all phases]
+
+## Quick Reference Checklist
+
+- [ ] Task 1.1: [Title]
+- [ ] Task 1.2: [Title]
+- [ ] Task 2.1: [Title]
+
+## Next Steps
+
+1. Review task breakdown
+2. Run `/implement [task-id]` to start execution
+
+---
+
+*Tasks created with SDD Multi-Agent OpenCode*

package/.sdd/templates/todo-compact.md

@@ -0,0 +1,30 @@
+# Todo List: [Feature Name]
+
+**Task ID:** [task-id]
+**Created:** [date]
+**Status:** In Progress
+
+## Phase 1: [Phase Name]
+
+- [ ] Task 1.1: [Description]
+  - Dependencies: None
+  - Files: [files to create/modify]
+- [ ] Task 1.2: [Description]
+  - Dependencies: Task 1.1
+  - Files: [files to create/modify]
+
+## Phase 2: [Phase Name]
+
+- [ ] Task 2.1: [Description]
+  - Dependencies: Phase 1 complete
+  - Files: [files to create/modify]
+
+## Progress Log
+
+| Task | Status | Completed At | Notes |
+|------|--------|--------------|-------|
+| | | | |
+
+---
+
+*Todo list created with SDD Multi-Agent OpenCode*

package/README.md

@@ -0,0 +1,272 @@
+# SDD Multi-Agent OpenCode
+
+Spec-Driven Development framework for OpenCode with multi-agent orchestration, DAG-based parallel execution, and free-tier model optimization.
+
+Inspired by [spec-kit-command-cursor](https://github.com/madebyaris/spec-kit-command-cursor), rebuilt from scratch for OpenCode's multi-agent architecture.
+
+## Layering
+
+This repo is the **SDD workflow layer**. For base agent behavior, CLI-first scaffolding, status verification, and context-window management, use [`opencode-agent-rules`](https://github.com/TudeOrangBiasa/opencode-agent-rules) first.
+
+```txt
+opencode-agent-rules        # base behavior + context/compaction policy
+        ↓
+sdd-multiagent-opencode     # SDD commands, agents, skills, templates
+        ↓
+external UI skills          # impeccable, taste, nothing-design, etc.
+```
+
+## What's Different from the Original
+
+| Aspect | Original (Cursor) | This (OpenCode) |
+|--------|-------------------|-----------------|
+| **Models** | Single `inherit` model | 4 models optimized per agent role |
+| **Parallel Execution** | Cursor `is_background: true` | OpenCode subagent spawning via Task tool |
+| **Codebase Search** | grep/glob | `codebase-memory-mcp` graph queries |
+| **Web Research** | Cursor web search | `exa_web_search_exa` |
+| **Visual Verification** | N/A | Chrome DevTools + Qwen (image-capable) |
+| **Hooks** | `hooks.json` | Plugin JS/TS with event system |
+| **Cost** | Per-token billing | All free-tier models |
+
+## Multi-Agent Architecture
+
+| Agent | Model | Role |
+|-------|-------|------|
+| **sdd-orchestrator** | `opencode/gpt-5.5` | DAG scheduling, conflict detection, deadlock handling |
+| **sdd-planner** | `opencode/gpt-5.5` | Architecture design, technical planning |
+| **sdd-explorer** | `opencode/deepseek-v4-flash-free` | Codebase discovery (readonly) |
+| **sdd-implementer** | `opencode/deepseek-v4-flash-free` | Code generation (high token usage) |
+| **sdd-verifier** | `opencode/qwen3.6-plus-free` | Completeness check + visual/UI verification (Chrome DevTools) |
+| **sdd-reviewer** | `opencode/minimax-m2.5-free` | Code review (security, performance, spec compliance) |
+
+## Quick Start
+
+### npx Install (Recommended)
+
+```bash
+cd your-project
+npx sdd-multiagent-opencode init
+```
+
+This installs both:
+- Base OpenCode agent rules (verification, CLI-first, context budget)
+- SDD multi-agent workflow (commands, agents, skills, templates)
+
+**Flags:**
+```bash
+npx sdd-multiagent-opencode init          # Install everything
+npx sdd-multiagent-opencode init --sdd-only    # SDD workflow only
+npx sdd-multiagent-opencode init --rules-only   # Base rules only
+npx sdd-multiagent-opencode init --force         # Overwrite existing
+npx sdd-multiagent-opencode init --dry-run       # Preview only
+```
+
+### 1. Install (Manual)
+
+#### Option A: Using Commands (Recommended)
+
+If you have OpenCode running, you can use the init commands:
+
+```
+/init-rules   # Install base agent rules first
+/init-sdd    # Install SDD workflow layer
+```
+
+#### Option B: Manual Copy
+
+```bash
+# Recommended: install base agent rules first
+git clone https://github.com/TudeOrangBiasa/opencode-agent-rules.git
+
+# Clone into your project
+git clone https://github.com/TudeOrangBiasa/sdd-multiagent-opencode.git
+
+# Or copy the .opencode/ and .sdd/ directories into your project
+cp opencode-agent-rules/AGENTS.md /your-project/
+cp -r opencode-agent-rules/.opencode/rules /your-project/.opencode/
+cp -r opencode-agent-rules/.opencode/plugins /your-project/.opencode/
+cp -r sdd-multiagent-opencode/.opencode /your-project/
+cp -r sdd-multiagent-opencode/.sdd /your-project/
+cp sdd-multiagent-opencode/opencode.json /your-project/
+```
+
+### 2. Configure
+
+Merge the `agent` and `permission` sections from `opencode.json` into your project's `opencode.json`.
+
+### 3. Update Project Profile
+
+Edit `.sdd/project-profile.json` with your stack:
+- framework (e.g., "next", "react", "express")
+- language (e.g., "typescript", "javascript")
+- packageManager (e.g., "pnpm", "npm", "yarn")
+- commands (dev, build, test, lint)
+
+### 4. Use
+
+```bash
+# Quick planning (80% of features)
+/brief user-auth JWT authentication with login/logout
+
+# Full planning (complex features)
+/research database-engine Best database for our use case --deep
+/specify user-auth User authentication with login, logout, password reset
+/plan user-auth
+/tasks user-auth
+/implement user-auth
+
+# TDD workflow (test-driven development)
+/tasks user-auth --tdd
+/implement user-auth --tdd
+
+# Full project roadmap
+/sdd-full-plan blog-platform Full-featured blog with CMS and analytics
+/execute-parallel blog-platform --until-finish
+
+# Audit
+/audit user-auth
+```
+
+## Commands
+
+| Command | Purpose | Output |
+|---------|---------|--------|
+| `/init-rules` | Install base agent rules | Base rules files |
+| `/init-sdd` | Install SDD workflow | SDD files + project profile |
+| `/brief` | Lightweight feature brief (~30 min) | `feature-brief.md` |
+| `/research` | Pattern investigation (supports `--deep`) | `research.md` |
+| `/specify` | Detailed requirements | `spec.md` |
+| `/plan` | Technical architecture | `plan.md` |
+| `/tasks` | Task breakdown | `tasks.md` |
+| `/implement` | Execute implementation with todo tracking | Code + `todo-list.md` |
+| `/sdd-full-plan` | Complete project roadmap | `roadmap.json` + tasks |
+| `/execute-parallel` | Parallel DAG execution | Updated roadmap |
+| `/execute-task` | Single task execution | Updated roadmap |
+| `/evolve` | Update specs with discoveries | Updated specs |
+| `/refine` | Iterate on specs through discussion | Updated docs |
+| `/upgrade` | Brief → Full SDD planning | Full SDD docs |
+| `/audit` | Compare implementation against specs | Audit report |
+| `/generate-prd` | PRD via Socratic questions | `full-prd.md` |
+| `/generate-rules` | Auto-generate coding rules | Rule files |
+| `/grill-me` | Clarify product requirements | Clarified brief |
+
+## Project Structure
+
+```
+.opencode/
+├── opencode.json          # Agent configs, permissions, model assignments
+├── agents/
+│   ├── sdd-orchestrator.md   # DAG coordinator (GPT 5.5)
+│   ├── sdd-planner.md        # Architecture designer (GPT 5.5)
+│   ├── sdd-explorer.md       # Codebase investigator (DeepSeek)
+│   ├── sdd-implementer.md    # Code generator (DeepSeek)
+│   ├── sdd-verifier.md       # Completeness checker (Qwen + Chrome)
+│   └── sdd-reviewer.md       # Code reviewer (MiniMax)
+├── commands/
+│   ├── brief.md              # /brief
+│   ├── research.md           # /research
+│   ├── specify.md            # /specify
+│   ├── plan.md               # /plan
+│   ├── tasks.md              # /tasks
+│   ├── implement.md          # /implement
+│   ├── sdd-full-plan.md      # /sdd-full-plan
+│   ├── execute-parallel.md   # /execute-parallel
+│   ├── execute-task.md       # /execute-task
+│   ├── evolve.md             # /evolve
+│   ├── refine.md             # /refine
+│   ├── upgrade.md            # /upgrade
+│   ├── audit.md              # /audit
+│   ├── generate-prd.md       # /generate-prd
+│   └── generate-rules.md     # /generate-rules
+└── skills/
+    ├── sdd-research/SKILL.md
+    ├── sdd-planning/SKILL.md
+    ├── sdd-implementation/SKILL.md
+    ├── sdd-audit/SKILL.md
+    └── sdd-evolve/SKILL.md
+
+.sdd/
+├── config.json               # Project configuration
+├── project-profile.json      # Stack and skill routing config
+└── templates/                # Document templates
+    ├── feature-brief-v2.md
+    ├── spec-compact.md
+    ├── plan-compact.md
+    ├── tasks-compact.md
+    ├── research-compact.md
+    ├── todo-compact.md
+    ├── roadmap-template.json
+    └── roadmap-template.md
+
+specs/
+├── active/                   # Features in development
+├── backlog/                  # Future features
+├── completed/                # Delivered features
+└── todo-roadmap/             # Project roadmaps with DAG
+```
+
+## Workflows
+
+### Quick Planning (80% of features)
+```
+/brief → /evolve → /refine → /implement
+```
+
+### Full Planning (complex features)
+```
+/research → /specify → /plan → /tasks → /implement
+```
+
+### Deep Research (unfamiliar domain)
+```
+/research --deep → /specify → /plan → /tasks → /implement
+```
+
+### Parallel Execution (project roadmap)
+```
+/sdd-full-plan → /execute-parallel --until-finish
+```
+
+### TDD Workflow (Test-Driven Development)
+
+```
+/brief feature-x → /tasks feature-x --tdd → /implement feature-x --tdd
+```
+
+With `--tdd` flag:
+- `/tasks` generates TDD-specific tasks with test-first structure
+- `/implement` writes failing test → implements minimum code → verifies pass → refactors
+
+**Example:**
+```
+/tasks user-auth --tdd
+/implement user-auth --tdd
+```
+
+## Tools Integration
+
+### codebase-memory-mcp
+Used by `sdd-explorer` and `sdd-implementer` for:
+- `search_graph` — find functions, classes, routes by natural language
+- `trace_path` — trace call chains and dependencies
+- `get_code_snippet` — read specific function/class source code
+- `query_graph` — run Cypher queries for complex patterns
+- `get_architecture` — high-level project structure
+
+### exa_web_search_exa
+Used by `sdd-explorer` and `sdd-research` skill for:
+- External pattern research
+- Documentation lookup
+- Technology comparison
+- Deep research mode (`--deep`)
+
+### chrome-devtools
+Used by `sdd-verifier` for:
+- `chrome-devtools_navigate_page` — navigate to feature pages
+- `chrome-devtools_take_screenshot` — capture visual state
+- `chrome-devtools_take_snapshot` — analyze DOM structure
+- `chrome-devtools_list_console_messages` — check for errors
+
+## License
+
+MIT