Skip to content
Prompt

nano-spec — Windsurf Rules

by tao-hpu

AI Summary

nano-spec is a lightweight, four-document specification methodology designed to help developers plan and document AI-assisted tasks in Windsurf through structured README, TODO, technical docs, and progress logs. It benefits teams wanting rapid, spec-driven development without heavyweight documentation overhead.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to add the "nano-spec — Windsurf Rules" prompt rules to my project.
Repository: https://github.com/tao-hpu/nano-spec

Please read the repo to find the rules/prompt file, then:
1. Download it to the correct location (.cursorrules, .windsurfrules, .github/prompts/, or project root — based on the file type)
2. If there's an existing rules file, merge the new rules in rather than overwriting
3. Confirm what was added

Description

Spec-driven thinking, nano-sized docs. Lightweight task specification for AI-assisted development.

What is nano-spec?

A lightweight task specification methodology using 4 documents: • README.md (Context) • todo.md (Plan + Acceptance Criteria) • doc.md (Technical Decisions) • log.md (Progress Journal)

When to Create a nano-spec

• User asks to "create a spec for..." • User asks to "plan a task..." • User describes a multi-step development task • User wants to document a technical decision

Step 1: Understand the Task

Ask clarifying questions if the description is vague: • What's the end goal? • What's explicitly NOT in scope? • Are there dependencies on other work?

Step 2: Create Files

Generate in tasks/{task-name}/ or project root, following the exact structure below: README.md `markdown

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 2mo ago
Active
AdoptionUnder 100 stars
37 ★ · Niche
DocsREADME + description
Well-documented

GitHub Signals

Stars37
Forks4
Issues0
Updated2mo ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Any AI assistant that accepts custom rules or system prompts

Claude
ChatGPT
Cursor
Windsurf
Copilot
+ more