Aider project skeleton

A personal template for starting new projects with AI coding tools. Focused on disciplined AI assisted development. Loads SPEC, ARCH, CONVENTIONS and TESTS into AI context automatically so the model works against documented requirements instead of vibes.

Quick start

git clone git@git.sirian.me:sirian/template-project.git my-project
cd my-project
rm -rf .git && git init && git add . && git commit -a -m "Initial commit from skeleton"

Minimum starting point

Before writing any code fill these two things:

1. SPEC.md

What are you building and who is it for?

2. ARCH.md

Stack and commands. What technologies and what commands does the AI need to know?

What's in here

.aider.conf.yml - Aider config (models, auto-test..)
.gitignore - Common stuff easy to forget.
docs/SPEC.md - What the project does
docs/ARCH.md - How it's built
docs/CONVENTIONS.md - Code style rules
docs/JOURNAL.md - Personal session notes

Philosophy

LLMs work well as translation layers from clear specs to code. Badly as substitutes for engineering thinking. The discipline files exist to keep the human doing the part humans should do (deciding what gets built, what correctness looks like, what constraints matter) and the AI doing the part it's good at (translating that into syntax).

1.3 KiB Raw Permalink Blame History