[Start] / Middle / [End]

Español 🇪🇸 | 中文 🇨🇳 | Deutsch 🇩🇪 | Français 🇫🇷 | 日本語 🇯🇵 | 한국어 🇰🇷 | Português 🇧🇷 | Русский 🇷🇺 | Tiếng Việt 🇻🇳 | हिन्दी 🇮🇳 | العربية 🇸🇦...

Bootstrap new projects with confidence. Iteratively refine and harden them as they grow. Perform deep, safe refactoring when the architecture needs to evolve.

npx skills add https://github.com/bastndev/skills --skill end

The Three Phases

Phase	Purpose	Key Capabilities	Example Skills	Status
Start	Project initialization & scaffolding	Create production-ready folder structures, initialize frameworks, apply best-practice defaults and configs from commit #1.	start-nextjs, start-vite, start-fastapi...	ㅤㅤ✅
Middle	Continuous improvement & polish	Enhance UI/UX, harden security, boost performance, clean logic, eliminate dead code, improve maintainability — during active development.	Targeted enhancers (TBD)	Planned
End	Audit, diagnosis & safe refactoring	Full architecture & quality analysis. Categorized findings with file-level evidence. Prioritized phased plan executed only with explicit approval. Behavior-preserving. Multi-runtime support.	refactor-project (the end skill)	ㅤㅤ✅

Available Skills

Skill

Description

end

refactor-project — Understands your project end-to-end. Delivers a clear diagnosis (confirmed bugs, risks, opportunities, technical debt) with concrete references. Recommends the right architecture direction for this codebase and builds an ordered execution plan. Every change happens in an isolated, reviewable phase. You stay in full control: the skill only proceeds when you say go, start, or proceed. No files are touched during analysis. → Full documentation & examples

Note: Each skill ships with its own detailed README. The root page gives the high-level overview; dive into ./skills/<skill>/README.md for deep usage, report examples, and guarantees.

Installation

# Install the End skill (refactor-project)
npx skills add bastndev/skills --skill end

Additional skills (once released) are installed the same way:

npx skills add bastndev/skills --skill start-nextjs

How the End Skill Works

1. Analysis first — Maps entry points and understands the project. Zero files are modified.
2. Structured report — Clear findings in four categories (Confirmed Bugs with severity, Risks, Refactoring Opportunities, Technical Debt) + an architecture recommendation and ordered plan. All items include concrete file + line references.
3. You authorize every phase — It executes exactly one phase at a time. After each phase you get a precise summary of changes, validations performed, and the list of remaining phases.
4. Full control & safety — Never creates tests if the project had none. Never adds dependencies or changes the package manager without permission. Respects your uncommitted work and always preserves current behavior unless fixing a justified bug.

For the complete workflow, exact report formats (including the required closing blocks), architecture decision rules, and all safety guarantees, read the dedicated skill documentation:

→ End – Refactor Project

The full internal specification lives in skills/end/SKILL.md.

Roadmap

• Start skills — One-command project scaffolding for popular stacks (Next.js, Vite, FastAPI, etc.)
• Middle skills — Focused, on-demand improvers (performance, security, UX, dead-code removal, etc.)
• End expansions — More runtimes, additional specialized refactoring modes, and utilities

Each skill will have its own dedicated documentation (like the current End – Refactor Project).

---

_{Built for developers who want their AI agents to act with the discipline of a senior engineer.}

If you find any bugs or have feedback, feel free to open an issue.

_{Made in 🇵🇪 by Gohit X · Licensed under MIT}