Back to Projects

webapp-blueprint

A project template that brings together conventions, checks, and an initialization process for building web applications with coding agents.

View on GitHub

Overview

webapp-blueprint is a project template for starting web application development with coding agents. Rather than cloning a fixed stack and accepting its defaults, it begins by clarifying what will be built, researching the relevant material, and discussing technical choices before materializing the selected structure.

The repository includes more than application scaffolding. It also contains principles, tool-specific recipes, validation scripts, and skills for coding agents. The goal is to start development with conventions that can be checked by linting and tests wherever possible, instead of relying on prompts alone.

What I Built

  • Interactive Bootstrap

    Clarifies the product and technical choices before materializing only the selected project structure.

  • Three-Layer Conventions

    Separates durable principles, replaceable recipes, and the current configuration and scripts.

  • Mechanical Checks

    Provides one execution path for linting, type checks, tests, dependency rules, and architecture checks.

  • Context for Coding Agents

    Uses AGENTS.md, skills, and searchable design documents to provide implementation context.

Problems

  • Avoiding implicit template defaults for decisions that belong to each project.
  • Turning statically enforceable conventions into checks instead of leaving them only in prose.
  • Keeping durable principles separate from tool-specific configuration.

Results

  • Created a workflow for bootstrapping a project through a structured conversation with a coding agent.
  • Made design documents, implementation conventions, and validation commands available in one repository.
  • Built in a secrets-by-reference workflow using 1Password references instead of plaintext values.