SpecLite Skill

A lightweight system to run projects with just enough planning + clear execution.

---

What it does

• Sets up a minimal planning structure
• Adapts to existing repos instead of overwriting them
• Keeps work tracked through simple stories
• Avoids process bloat

---

Modes

Repo mode

• Bootstrap → new or empty repo
• Existing → adapt what’s already there

Interaction mode

• Guided → asks a few key questions
• Fast-path → assumes and proceeds

---

Core idea

• Don’t replace working systems
• Plan only what’s needed
• No work without a tracked story
• Risk decides how much rigor is needed

---

Default setup

planning/
  vision.md
  bookkeeping.md
  story-management.md
  testing-strategy.md
  design-direction.md

stories/
  index.md

---

Stories (how work happens)

• Start with a story
• Move it → doing
• Implement
• Verify
• Record result
• Move to done

---

Testing (pick based on risk)

• L1: docs / planning
• L2: simple UI
• L3: logic / integrations
• L4: critical work

---

Rules

• Don’t duplicate systems
• Don’t overwrite existing structure
• Respect canonical docs if they exist
• Keep everything minimal

---

When to use

• Real projects where you want structure
• AI-assisted builds where things can drift

When not to

• Quick throwaway work

---

TL;DR

Plan a little. Track everything. Don’t overcomplicate.