--- name: solo-setup-96b2be01e7aa description: Auto-generate project workflow config (docs/workflow.md) from existing PRD and CLAUDE.md with zero questions. Use when user says "set up workflow", "configure TDD", "wire up dev workflow", or after running /scaffold before /plan. Do NOT use for founder setup (use /init) or project scaffolding (use /scaffold). license: MIT metadata: author: fortunto2 version: "2.1.1" openclaw: emoji: "⚙️" allowed-tools: Read, Grep, Bash, Glob, Write, Edit, AskUserQuestion, mcp__solograph__project_info, mcp__solograph__codegraph_query, mcp__solograph__kb_search argument-hint: "[project-name]" --- # /setup Auto-generate project workflow config from existing PRD and CLAUDE.md. Zero interactive questions — all answers extracted from project data that already exists after `/scaffold`. ## When to use After `/scaffold` creates a project, before `/plan`. Creates `docs/workflow.md` so `/plan` and `/build` can work. ## MCP Tools (use if available) - `project_info(name)` — get project details, detected stack - `kb_search(query)` — search for dev principles, manifest, stack templates - `codegraph_query(query)` — check project dependencies in code graph If MCP tools are not available, fall back to reading local files only. ## Steps 1. **Detect project root:** - If `$ARGUMENTS` is provided, look for a project with that name in the current directory or `projects_dir` from `~/.solo-factory/defaults.yaml`. - Otherwise use current working directory. - Verify the directory exists and has `CLAUDE.md`. - If not found, ask via AskUserQuestion. 2. **Check if already initialized:** - If `docs/workflow.md` exists, warn and ask whether to regenerate. 3. **Read project data** (parallel — all reads at once): - `CLAUDE.md` — tech stack, architecture, commands, Do/Don't - `docs/prd.md` — problem, users, solution, features, metrics, pricing - `package.json` or `pyproject.toml` — exact dependency versions - `Makefile` — available commands - Linter configs (`.eslintrc*`, `eslint.config.*`, `.swiftlint.yml`, `ruff.toml`, `detekt.yml`) 4. **Read ecosystem sources** (optional — enhances quality): - Detect stack name from CLAUDE.md (look for "Stack:" or the stack name in tech section). - If MCP `kb_search` available: search for stack template and dev-principles. - Otherwise: look for `stacks/.yaml` and `dev-principles.md` in `.solo/` or plugin templates directory (if accessible). - If neither available: derive all info from CLAUDE.md + package manifest (sufficient). 5. **Detect languages** from package manifest: - `package.json` → TypeScript - `pyproject.toml` → Python - `*.xcodeproj` or `Package.swift` → Swift - `build.gradle.kts` → Kotlin 6. **Create docs directory if needed:** ```bash mkdir -p docs ``` 7. **Generate `docs/workflow.md`:** Based on dev-principles (from MCP/KB or built-in defaults): ```markdown # Workflow — {ProjectName} ## TDD Policy **Moderate** — Tests encouraged but not blocking. Write tests for: - Business logic and validation - API route handlers - Complex algorithms Tests optional for: UI components, one-off scripts, prototypes. ## Test Framework {from package manifest devDeps: vitest/jest/pytest/xctest} ## Commit Strategy **Conventional Commits** Format: `(): ` Types: feat, fix, refactor, test, docs, chore, perf, style ## Verification Checkpoints **After each phase completion:** 1. Run tests — all pass 2. Run linter — no errors 3. Run build — successful (if applicable) 4. Manual smoke test ## Branch Strategy - `main` — production-ready - `feat/` — feature branches - `fix/` — hotfixes ``` 8. **Update `CLAUDE.md`** — add workflow reference to Key Documents section if not present. 9. **Show summary and suggest next step:** ``` Setup complete for {ProjectName}! Created: docs/workflow.md — TDD moderate, conventional commits Next: /plan "Your first feature" ``` ## Common Issues ### CLAUDE.md not found **Cause:** Project not scaffolded or running from wrong directory. **Fix:** Run `/scaffold` first, or ensure you're in the project root with CLAUDE.md. ### workflow.md already exists **Cause:** Previously set up. **Fix:** Skill warns and asks whether to regenerate. Existing file is preserved unless you confirm overwrite. ### Wrong test framework detected **Cause:** Multiple test frameworks in devDependencies. **Fix:** Skill picks the first found. Edit `docs/workflow.md` manually to specify the correct framework. --- Source attribution: fortunto2 Original project: https://github.com/meghal86/stacksignal/blob/54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44/.agents/skills/solo-setup/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: fortunto2 Original project: https://github.com/meghal86/stacksignal/blob/54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44/.agents/skills/solo-setup/SKILL.md Attribution basis: Source repository record Fields of work: Product Management, Project & Program Management, Development & Engineering Roles: Product Manager, Project Manager, Backend Developer, DevOps / SRE, Growth Product Manager Specialties: Backend Tools: Claude Country applicability: Country not specified Classification basis: Source category, role and specialization labels Instruction SHA-256: 9cdcf242bdefbf688b608a30806f3b99293580f5e760893fb0a907cabd9da183