seed-qwen-ai
v1.0.1
Published
Typed project incubator for Qwen CLI - guided ideation through graduation into buildable projects
Maintainers
Readme
SEED-Qwen
Typed Project Incubator for Qwen CLI — guided ideation through graduation into buildable projects.
What is SEED?
SEED takes raw ideas through structured, type-aware exploration and produces comprehensive PLANNING.md documents ready for building.
Raw Idea → SEED → PLANNING.md → PAUL → Built ProjectQuick Start
Install
npx seed-qwen-aiOr specify location:
# Global (all projects)
npx seed-qwen-ai --global
# Local (current project)
npx seed-qwen-ai --localStart Ideation
/seedLaunch with PAUL
/seed launchThis graduates your project AND initializes PAUL in one step — no re-asking questions.
Project Types (5)
| Type | Rigor | Purpose | |------|-------|---------| | Application | Deep | Software with UI, data model, API, deployment | | Workflow | Standard | Claude Code commands, hooks, skills | | Client | Standard | Client websites — business context, conversion | | Utility | Tight | Small tools, scripts, single-purpose | | Campaign | Creative | Content, marketing, launches |
Commands
| Command | Description |
|---------|-------------|
| /seed | Start guided ideation (default) |
| /seed graduate | Move to apps/ with git repo + README |
| /seed launch | Graduate + initialize PAUL (headless) |
| /seed status | Show all projects in pipeline |
| /seed add-type | Create custom project type |
The SEED → PAUL Pipeline
Step 1: Ideation (/seed)
1. Select project type
2. Guided conversation (type-specific)
3. Generate PLANNING.mdStep 2: Graduation (/seed graduate)
1. Quality gate check
2. Move to apps/{name}/
3. Git init + READMEStep 3: Launch (/seed launch)
1. All Graduation steps
2. PAUL initialized headlessly
3. PLANNING.md → ROADMAP.md, PROJECT.md
4. Ready for /paul/planFile Structure
projects/
└── {project-name}/
└── PLANNING.md # Generated during ideation
apps/
└── {project-name}/
├── PLANNING.md # Copied from projects/
├── README.md # Generated during graduation
└── .paul/ # Created by /seed launch
├── PROJECT.md
├── ROADMAP.md
└── STATE.mdExample Session
# Start ideation
/seed
# Select: Application
# Answer guided questions...
# PLANNING.md generated
# Graduate and launch
/seed launch my-app
# Now in apps/my-app/ with PAUL ready
/paul/plan # Create first executable plan
/paul/apply # Build it
/paul/unify # Close loopCustom Project Types
Add your own types:
/seed add-typeCreates:
~/.qwen/seed-framework/data/{type}/config.md~/.qwen/seed-framework/data/{type}/guide.md~/.qwen/seed-framework/data/{type}/skill-loadout.md
Quality Gates
Before graduation, SEED verifies:
Universal:
- Problem statement clear
- Target users defined
- Phases outlined
- Next actions clear
Type-Specific:
- Application: Tech stack resolved, data model defined
- Workflow: Trigger mechanism clear
- Client: Conversion path defined
- Utility: Single purpose (no scope creep)
- Campaign: Measurable goal, timeline set
Integration with PAUL-Qwen
SEED works standalone or with PAUL-Qwen:
Standalone:
/seed graduate # Just create the project
# Build however you wantWith PAUL:
/seed launch # Graduate + PAUL init
/paul/plan # Start structured buildInstallation Options
Interactive (Default)
npx seed-qwenNon-Interactive
# Global
npx seed-qwen --global
# Local
npx seed-qwen --local
# Custom path
npx seed-qwen --config-dir ~/.qwen-customHelp
npx seed-qwen --helpUpdating
npx seed-qwen@latestComparison: SEED vs Ad-Hoc Planning
| Aspect | Ad-Hoc | SEED | |--------|--------|------| | Structure | None | Type-guided | | Output | Notes, fragments | Structured PLANNING.md | | Graduation | Manual | Automated | | PAUL Handoff | Re-asks questions | Headless (zero re-asking) | | Quality | Variable | Gate-checked |
When to Use SEED
Good Fit
- New project from scratch
- Vague idea needs shaping
- Want structured plan before building
- Team alignment needed
Overkill
- Quick scripts (use Utility type anyway)
- Experiments/prototypes
- Already have detailed spec
Troubleshooting
Commands Not Found
# Verify installation
ls ~/.qwen/commands/seed/
# Restart Qwen CLIPLANNING.md Incomplete
Run quality gate manually:
/seed graduate # Will show what's missingContributing
- Fork the repo
- Make changes
- Test with real projects
- Submit PR
GitHub: https://github.com/tyler1350/seed-qwen
License
MIT License — see LICENSE file.
Credits
SEED-Qwen is a port of the SEED Framework by Chris Kahler, adapted for Qwen CLI.
Part of the PAUL ecosystem:
- SEED — Project incubator (ideation → planning)
- PAUL — Project orchestration (plan → apply → unify)
SEED-Qwen v1.0 | For Qwen CLI | Typed Project Incubator
