This repository has been archived on 2026-08-07. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
kb-skills/gsd-openclaw/.planning/REQUIREMENTS.md
T

103 lines
3.9 KiB
Markdown

# Requirements: gsd-openclaw
**Defined:** 2026-03-10
**Core Value:** 让用户在任何通讯软件中,随时与 AI 代理协作完成软件开发项目
## v1 Requirements
Requirements for initial release. Each maps to roadmap phases.
### Session Management
- [x] **SESS-01**: User can create tmux session for a project workspace
- [x] **SESS-02**: User can list active tmux sessions with their project associations
- [x] **SESS-03**: User can destroy a tmux session when project is complete
- [x] **SESS-04**: Session state persists across server restarts via JSON checkpointing
- [x] **SESS-05**: User can resume interrupted sessions with full context restoration
- [x] **SESS-06**: Each project has isolated workspace (separate tmux session + directory)
- [x] **SESS-07**: Multiple users can run projects concurrently without interference
### Command Bridging
- [ ] **BRDG-01**: User can send any GSD slash command through chat (e.g., /gsd:new-project)
- [x] **BRDG-02**: Command output is captured and returned to user through chat
- [x] **BRDG-03**: User receives clear error messages when commands fail
- [ ] **BRDG-04**: User can approve/reject GSD workflow gates through chat responses
- [ ] **BRDG-05**: User receives periodic progress updates during long-running operations
- [ ] **BRDG-06**: All GSD slash commands are supported (no command left behind)
### OpenClaw Integration
- [x] **OCLW-01**: SKILL.md has proper frontmatter (name, description, triggers)
- [x] **OCLW-02**: Skill triggers on /gsd:* patterns and project management keywords
- [ ] **OCLW-03**: orchestrator.py routes commands to appropriate handlers
- [x] **OCLW-04**: Response formatting adapts to channel capabilities (markdown vs plain)
- [ ] **OCLW-05**: Skill integrates with OpenClaw's security model (dmPolicy, allowlists)
- [ ] **OCLW-06**: Multi-channel support works (WeChat, Feishu, Telegram, Discord, etc.)
## v2 Requirements
Deferred to future release. Tracked but not in current roadmap.
### Advanced Features
- **NOTIF-01**: Proactive notifications when long-running tasks complete
- **NOTIF-02**: Intelligent retry with exponential backoff
- **BRNCH-01**: Session branching for "what if" exploration
- **HNDOF-01**: Session handoff between channels
- **CNTXT-01**: Intelligent context management (auto-summarize long sessions)
- **HIST-01**: Command history search across sessions
### Multi-Agent
- **AGNT-01**: Multi-agent coordination (spawn sub-agents for parallel tasks)
- **AGNT-02**: Agent result aggregation and reporting
## Out of Scope
Explicitly excluded. Documented to prevent scope creep.
| Feature | Reason |
|---------|--------|
| GSD core modifications | Pure bridging - all GSD logic stays in GSD core |
| Mobile native app | Chat apps already cover mobile via OpenClaw |
| Custom auth system | Use OpenClaw's security model (dmPolicy, allowlists) |
| Real-time streaming output | Most chat APIs don't support streaming |
| Web dashboard | OpenClaw has control UI at :18789 |
| Custom tmux UI | tmux is implementation detail, not product |
## Traceability
Which phases cover which requirements. Updated during roadmap creation.
| Requirement | Phase | Status |
|-------------|-------|--------|
| SESS-01 | Phase 1 | Complete |
| SESS-02 | Phase 1 | Complete |
| SESS-03 | Phase 1 | Complete |
| SESS-04 | Phase 1 | Complete |
| SESS-05 | Phase 1 | Complete |
| SESS-06 | Phase 1 | Complete |
| SESS-07 | Phase 1 | Complete |
| BRDG-01 | Phase 3 | Pending |
| BRDG-02 | Phase 3 | Complete |
| BRDG-03 | Phase 3 | Complete |
| BRDG-04 | Phase 3 | Pending |
| BRDG-05 | Phase 3 | Pending |
| BRDG-06 | Phase 4 | Pending |
| OCLW-01 | Phase 2 | Complete |
| OCLW-02 | Phase 2 | Complete |
| OCLW-03 | Phase 3 | Pending |
| OCLW-04 | Phase 2 | Complete |
| OCLW-05 | Phase 3 | Pending |
| OCLW-06 | Phase 3 | Pending |
**Coverage:**
- v1 requirements: 19 total
- Mapped to phases: 19
- Unmapped: 0 ✓
---
*Requirements defined: 2026-03-10*
*Last updated: 2026-03-10 after initial definition*