Introduction
# Idea Coach
> Your critical sparring partner for ideas, problems, and challenges — now with GitHub integration!
## What It Does
Idea Coach helps you: - **Capture** ideas, problems, and challenges as they come - **Categorize** by type, domain, energy, urgency, and importance - **Review** periodically (daily → quarterly based on importance) - **Ship** ideas to GitHub repos when ready - **Track** progress and know when to let go
## Philosophy
**Be critical, not just supportive.** Idea Coach will: - Suggest dropping ideas that aren't worth pursuing - Ask hard questions during reviews - Track which ideas actually ship vs. rot forever
## Commands
### Core Commands
| Command | Description | |---------|-------------| | `/idea <text>` | Capture a new idea | | `/idea_list` | List active ideas | | `/idea_list --due` | Show ideas due for review | | `/idea_get <id>` | Get idea details | | `/idea_update <id>` | Update idea attributes | | `/idea_review <id>` | Add review interaction | | `/idea_drop <id>` | Mark as dropped (requires reason) | | `/idea_done <id>` | Mark as completed | | `/idea_stats` | Show statistics |
### GitHub Commands
| Command | Description | |---------|-------------| | `/idea_link <id> <owner/repo>` | Link to existing repo | | `/idea_ship <id>` | Create new repo for idea | | `/idea_ship <id> --public` | Create public repo | | `/idea_repo <id>` | Show linked repo status | | `/idea_sync <id>` | Create/update GitHub issue |
## Attributes
### Types - 💡 **idea** — Something to build or create - 🔧 **problem** — Something to fix or solve - 🎯 **challenge** — Something to overcome
### Status Flow ``` captured → exploring → developing → shipped/done ↓ ↓ parked blocked ↓ dropped ```
### Importance → Review Cycle | Importance | Energy | Review Cycle | |------------|--------|--------------| | critical | high | daily | | critical | * | weekly | | important | high | weekly | | important | * | biweekly | | nice-to-have | * | monthly | | parked | * | quarterly |
## GitHub Integration
### Prerequisites - `gh` CLI installed and authenticated - Run `gh auth login` if not set up
### Workflow Example
``` # 1. Capture idea /idea "Build a CLI for task management"
# 2. Develop it /idea_update abc123 --status developing
# 3. Ship it to GitHub /idea_ship abc123
# 4. Or link to existing repo /idea_link abc123 moinsen-dev/my-cli
# 5. Check repo status /idea_repo abc123
# 6. Sync as GitHub issue /idea_sync abc123 ```
## CLI Usage
```bash # Add idea python scripts/coach.py add "Build something cool" --type idea --importance important
# List ideas python scripts/coach.py list python scripts/coach.py list --due python scripts/coach.py list --github # Only with linked repos
# GitHub operations python scripts/coach.py link <id> owner/repo python scripts/coach.py ship <id> --owner moinsen-dev python scripts/coach.py repo-status <id> python scripts/coach.py sync-issue <id> --labels enhancement,idea ```
## Data Storage
Ideas are stored in `~/.openclaw/idea-coach/ideas.json`
Each idea tracks: - Basic info (title, description, type, domain) - Status and progress - Energy, urgency, importance - Review schedule and history - **GitHub integration** (repo, issue, sync timestamps) - Interaction log
## Tips
1. **Capture quickly** — Don't overthink the initial capture 2. **Review honestly** — Use reviews to kill stale ideas 3. **Ship early** — Create a repo as soon as an idea has momentum 4. **Sync issues** — Use GitHub issues for detailed tracking 5. **Drop freely** — A dropped idea is a decision, not a failure