AI-Dev-Repo-Template-1

April 28, 2026 · View on GitHub

A GitHub template repository seeded with every primitive defined in AI-Dev-Workspace-Primitives.

Use this as the starting point for a new AI-assisted project. Click Use this template on GitHub, then fill in (or have an agent fill in) each UPPERCASE.md file at the repo root.

What's included

Every primitive is pre-seeded as a stub at the repo root with placeholder text and instructions to the user or agent on how to populate it:

FilePrimitive
USER_PROFILE.mdPer-repo user profile
ENVIRONMENT.mdDevelopment and deployment environment
SPEC.mdAuthoritative project specification
BUDGET.mdFinancial constraints and cost mitigation
PROJECT.mdPlan, architecture, decision history
TOOLS.mdNecessary / available tools
PROCESS.mdProject-specific dev processes
RULES.mdGuardrails and authorizations
PREFERENCES.mdPersistent stack preferences
LOG.mdRaw agent work log
STYLE.mdBrand palette / fonts / assets
SCAFFOLDS.mdPreferred scaffold or reference
DOCS.mdDocumentation style guide
GROUNDING.mdWhitelist of authoritative URLs
SECRETS.mdSecrets manifest (never values)
CONTEXT.mdLoose contextual scratchpad

How to use

  1. Click Use this template → Create a new repository.
  2. Open each UPPERCASE.md and replace the <!-- ... --> placeholders. Or hand the repo to an agent and ask it to populate them based on conversation context.
  3. Add a CLAUDE.md or AGENTS.md at the root that injects every UPPERCASE.md as foundational context.
  4. Delete primitives that aren't relevant to this project — opt-out is cheaper than opt-in.

See also