Use for ANY multi-step task, research, or complex implementation. This is the master cognitive framework replacing all older planning skills. It manages Analysis, Technical Planning, and Execution in one unified workflow.
smart-planning is the core architectural engine. It unifies Manus-style persistent memory (thinking in files), strict TDD-style step formulation, and safe batch execution into a single, cohesive workflow.
Core Principle: "Context Window = RAM (volatile, limited). Filesystem = Disk (persistent, unlimited). Everything important goes to Disk."
Announce at start: "Naudoju smart-planning įgūdį šios užduoties organizavimui ir vykdymui."
Before writing any code, determine the nature of the task:
notebook_id.agent/config.jsondocs/plans/findings.md to dump research findings (Domain Brain), API responses, and file structures.docs/plans/task_plan.md for high-level phase tracking (Manus style).Create a strict, bite-sized implementation plan at docs/plans/YYYY-MM-DD-<feature-name>.md.
Assume the executing session has zero context. Write exact file paths, exact code blocks to change, and exact commands to run.
Document Header Format:
# [Feature Name] Implementation Plan
**Goal:** [One sentence what this builds]
**Architecture:** [2-3 sentences]
Task Structure (Bite-Sized):
### Task 1: [Component Name]
**Files:**
- Create: `exact/path/to/file.py`
- Modify: `exact/path/to/existing.py:123-145`
**Step 1: Write/Update Code** (Provide exact diff or function replacement)
**Step 2: Verification** (Provide exact command: `npm run build` or `pytest ...`)
**Step 3: Commit** (Command: `git commit -am "feat: added X"`)
Note: DRY, YAGNI, TDD principles apply.
Once the plan is written (and approved by the user if it's a major change):
git add . && git commit -m "chore: auto-checkpoint before <feature>" IF the working tree is dirty. (Safety first!)The Agent MUST stop and notify the user immediately if:
gemini.md.This skill completely replaces and obsoletes:
planning-with-fileswriting-plansexecuting-plans
Do not use them. Use smart-planning.