ai-collab/project-templates
Watch
4
0
Fork
You've already forked project-templates
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Reusable application templates distilled from shipping apps. First template: FastAPI site-app shell (accounts, catalog, staff, ratings, hardening).
1 commit 1 branch 0 tags 34 KiB
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Grok cf9e02d288 Add the project-templates catalog and fastapi-site-app shell. 
This repository holds reusable application specifications, not a second
copy of a shipping app. The first template is the FastAPI site-app shell
distilled from Spin the Activity: accounts, catalog of owned records,
staff consoles, content ratings, mail, and HTTP hardening.

Rejected alternatives: vendoring a runnable duplicate of spin-the-activity
(would drift immediately), and a cookiecutter of stub Python that does
not boot (a broken skeleton is worse than a specification plus a working
reference). Instantiation lifts code from the reference and renames
through the glossary. Wheel, slices, spin modes, and celebration motion
stay domain in the working reference.
2026-09-14 18:08:24 -07:00
docs Add the project-templates catalog and fastapi-site-app shell. 2026-09-14 18:08:24 -07:00
templates/fastapi-site-app Add the project-templates catalog and fastapi-site-app shell. 2026-09-14 18:08:24 -07:00
.gitignore Add the project-templates catalog and fastapi-site-app shell. 2026-09-14 18:08:24 -07:00
AGENTS.md Add the project-templates catalog and fastapi-site-app shell. 2026-09-14 18:08:24 -07:00
LICENSE Add the project-templates catalog and fastapi-site-app shell. 2026-09-14 18:08:24 -07:00
README.md Add the project-templates catalog and fastapi-site-app shell. 2026-09-14 18:08:24 -07:00

README.md

Project templates

Reusable application templates for new Valley Geek apps. Each template is a product contract, runtime contract, package layout, glossary, and copy checklist. The working reference for a template is a shipping repository, not a second copy of that app's source.

This catalog is not a published website.

Forge: ai-collab/project-templates.

Templates

Directory Stack Use when Working reference
templates/fastapi-site-app Python 3.12, FastAPI, Jinja2, PostgreSQL, vanilla JS A new site needs accounts, a catalog of owned records, staff consoles, content ratings, mail, and HTTP hardening ai-collab/spin-the-activity

How to use a template

  1. Copy templates/<name>/ into a new repository (or start from these docs and lift code from the working reference).
  2. Fill templates/fastapi-site-app/docs/GLOSSARY.md with the new product's nouns and identifiers.
  3. Follow templates/fastapi-site-app/docs/APPLY.md.
  4. Lift code from the working reference. Rename through the glossary. Do not copy domain modules the checklist marks as out of the shell.

Catalog rules

Path Role
docs/DESIGN.md What this catalog is
templates/<name>/docs/DESIGN.md Product rules for that template
templates/<name>/docs/TECHNICAL.md Runtime contract
templates/<name>/docs/GLOSSARY.md Nouns and identifiers to replace
templates/<name>/docs/LAYOUT.md File placement
templates/<name>/docs/CHECKLIST.md Features to copy, adapt, or drop
templates/<name>/docs/APPLY.md Instantiation procedure

A template holds specifications and a prescribed tree. It does not ship a second runnable app. Domain features stay in the working reference.

Standards: agents/standards/documentation-standard.md, agents/standards/docs-authority.md, agents/standards/user-copy.md.

License

MIT. See LICENSE.