{"id":51610498,"url":"https://github.com/braboj/solid-ai-templates","last_synced_at":"2026-07-12T08:00:29.083Z","repository":{"id":345949086,"uuid":"1187973314","full_name":"braboj/solid-ai-templates","owner":"braboj","description":"Generate CLAUDE.md and AGENTS.md files from composable, SOLID-inspired templates","archived":false,"fork":false,"pushed_at":"2026-07-05T14:04:55.000Z","size":3609,"stargazers_count":3,"open_issues_count":30,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-05T16:03:20.896Z","etag":null,"topics":["12-factor","agents-md","ai-assisted-development","ai-workflow","claude-code","claude-md","code-quality","codex-cli","coding-standards","context-engineering","copilot","owasp","prompt-engineering","solid-principles"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/braboj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-21T12:54:28.000Z","updated_at":"2026-07-05T14:04:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"2c2e6e8e-fbcf-407b-aacd-340b8a3f9e05","html_url":"https://github.com/braboj/solid-ai-templates","commit_stats":null,"previous_names":["imbra-ltd/solid-ai-templates","braboj/solid-ai-templates"],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/braboj/solid-ai-templates","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/braboj%2Fsolid-ai-templates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/braboj%2Fsolid-ai-templates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/braboj%2Fsolid-ai-templates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/braboj%2Fsolid-ai-templates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/braboj","download_url":"https://codeload.github.com/braboj/solid-ai-templates/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/braboj%2Fsolid-ai-templates/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35385772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-12T02:00:06.386Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["12-factor","agents-md","ai-assisted-development","ai-workflow","claude-code","claude-md","code-quality","codex-cli","coding-standards","context-engineering","copilot","owasp","prompt-engineering","solid-principles"],"created_at":"2026-07-12T08:00:16.504Z","updated_at":"2026-07-12T08:00:29.004Z","avatar_url":"https://github.com/braboj.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SOLID-AI Templates\n\n*Forged in real work, not theorized — every rule here came from a real\nAI-assisted project.*\n\nYou've shipped the same CLAUDE.md three times this quarter. Each copy is\nslightly different, none of them are right, and the agent still doesn't\nknow your team's conventions.\n\nYou're not alone, and it's not negligence — writing context files from\nscratch is the quiet cost of every agent-assisted team. Everyone pays\nit, few teams have a system for it, and the codebase drifts a little\nfurther from your standards every sprint.\n\nThis repo gives you composable templates that codify your team's\nconventions once — base rules, stack rules, company rules — and feed\nthem to every agent on every project. Tax paid. Move on.\n\nBack to the work that actually moves the product. The spikes, the design\nconversations, the reviews that catch bugs instead of style nits. That's\nwhat your team's time is for.\n\n## What it does\n\n- Build `CLAUDE.md` or `AGENTS.md` from reusable layers — base, backend/frontend, stack\n- Fork and extend — layer your team's conventions on top of the base without modifying it\n- Output `CLAUDE.md` for Claude Code or `AGENTS.md` for Cursor, Copilot, Codex CLI\n- Codify industry standards — 12-factor app, OWASP, SOLID, SemVer, conventional commits\n- Run a 360-degree project assessment across four perspectives\n- Enforce standardized issue labels, quality gates, and review processes\n\n## How to use\n\n**Prerequisites:** a local coding agent that can read files from\nyour project directory (Claude Code, Cursor, Codex CLI, Windsurf,\nor similar).\n\n**Output:** a `CLAUDE.md` or `AGENTS.md` file placed at your project\nroot, containing coding conventions tailored to your stack. Works\nfor new projects and refactoring alike — the context file describes\nhow code *should be written*, giving your agent a consistent target\nwhether starting from scratch or improving existing code. Review and\nadjust the output before adopting it — results vary by model and\nprompt size.\n\n### Try it — clone and point the agent at the templates\n\n*Fastest path. The agent picks the stack on its own — least\ninput from you, most variance in output.*\n\nClone the repo and tell the agent to generate from it:\n\n```bash\ngit clone https://github.com/braboj/solid-ai-templates.git\n```\n\n1. Open your agent in your project directory\n2. Tell the agent:\n\n```\nUse solid-ai-templates/ to generate a CLAUDE.md for this\nproject. Start by reading templates/manifest.yaml to discover\nthe available stacks, then follow the [DEPENDS ON] chain for\nthe stack that fits.\n```\n\n3. The agent picks a matching stack, resolves the chain, and\n   drafts the file\n4. Review, adjust, and place at your project root\n\n### Use it — clone and run the interview\n\n*Guided path. The agent asks about your project before generating —\nslower, but tighter fit to your context.*\n\nClone the templates and let the agent guide you through setup:\n\n```bash\ngit clone https://github.com/braboj/solid-ai-templates.git\n```\n\n1. Open your agent in your project directory\n2. Tell the agent to read `solid-ai-templates/templates/INTERVIEW.md`\n3. The agent asks about your project, proposes a stack, and reads\n   the relevant templates\n4. Confirm the stack — the agent generates `CLAUDE.md` or `AGENTS.md`\n5. Place the generated file at your project root\n\nThe interview tends to produce a tighter fit than the\nmanifest-discovery path, because the agent gathers project\nspecifics from you before resolving the dependency chain (base\nrules, layer rules, stack rules). Results depend on the model and\ncontext window available.\n\n### Adopt it — vendor as a submodule\n\nFor teams that want version-pinned templates inside their repo:\n\n```bash\ncd my-project\ngit submodule add https://github.com/braboj/solid-ai-templates.git .ai-templates\n```\n\n1. Open your agent in your project directory\n2. Tell the agent to read `.ai-templates/templates/INTERVIEW.md`\n3. Follow the interview — the agent reads templates from the\n   submodule and generates your context file\n4. Commit the generated file alongside the submodule\n\nTo update templates: `git submodule update --remote`. Then\nre-run the interview to regenerate your context file with the\nlatest rules.\n\n## Model limitations\n\n| Stack category | Prompt size | Min context window |\n|----------------|-------------|-------------------|\n| Library / CLI | ~12K tokens | 32K |\n| Static site | ~15K tokens | 32K |\n| Backend service | ~25–50K tokens | 128K |\n| Full-stack | ~40–60K tokens | 128K |\n\n- **Output token limit \u003c 16K** (e.g. GPT-4o default): generated file\n  may be truncated — generate section by section or set `max_tokens`\n  to the model maximum\n- **Output token limit 32K+**: full inline file fits in one pass\n\n## Supported stacks\n\n\u003c!-- generated:readme-stacks --\u003e\n| Template | Layer | Description |\n|----------|-------|-------------|\n| `templates/stack/htmx.md` | hypermedia | HTMX 2.x, Alpine.js, SSE, OOB swaps, partial responses |\n| `templates/stack/static-site-astro.md` | static | Islands architecture, client directives, content collections |\n| `templates/stack/static-site-tutorial.md` | static | Multi-chapter tutorial, diagrams, CC BY-NC-SA |\n| `templates/stack/python-lib.md` | library | Installable package or CLI tool, mypy, ruff, pytest |\n| `templates/stack/python-service.md` | abstract | Generic Python web service, SQLAlchemy, Alembic |\n| `templates/stack/python-flask.md` | backend | Sync REST API, factory pattern, blueprints |\n| `templates/stack/python-fastapi.md` | backend | Async REST API, Pydantic v2, DI, OpenAPI |\n| `templates/stack/python-django.md` | backend | Full web framework, ORM, DRF, admin |\n| `templates/stack/go-lib.md` | library | Importable library or CLI binary |\n| `templates/stack/go-service.md` | abstract | Generic Go HTTP service, chi, structured logging |\n| `templates/stack/go-echo.md` | backend | REST API, Echo v4, middleware, validation |\n| `templates/stack/node-express.md` | backend | Minimal REST API, Zod validation, Supertest |\n| `templates/stack/node-nestjs.md` | backend | Modules, controllers, providers, guards, pipes, DI |\n| `templates/stack/go-grpc.md` | backend | gRPC service, bufconn, errgroup |\n| `templates/stack/python-grpc.md` | backend | gRPC service, grpcio-aio, proto design |\n| `templates/stack/nodejs-lib.md` | library | TypeScript npm package or CLI, tsup, Vitest |\n| `templates/stack/c-embedded.md` | embedded | GCC + CMake, Unity tests, HAL, binary + .a |\n\u003c!-- /generated:readme-stacks --\u003e\n\n## Supported agents\n\n| Agent | Output file |\n|-------|-------------|\n| Claude Code | `CLAUDE.md` |\n| Codex CLI, Devin, Cursor, Windsurf | `AGENTS.md` |\n\nSee `templates/base/core/agents.md` for structure, models, and formatting rules.\n\n## Links\n\n- [System design and composition rules](docs/SPEC.md)\n- [Project status and roadmap](https://github.com/braboj/solid-ai-templates/milestones)\n- [Example generated context files](examples/)\n- [Onboarding guide](docs/ONBOARDING.md)\n- [Operational playbook](docs/PLAYBOOK.md)\n- [Architecture decision records](docs/decisions/)\n- [Report an issue](https://github.com/braboj/solid-ai-templates/issues)\n\n## License\n\n[CC BY 4.0](LICENSE) — Creative Commons Attribution 4.0 International.\nYou are free to use, share, and adapt the templates for any purpose,\nincluding commercial use, as long as you give attribution.\n\n## Author\n\n[Branimir Georgiev](https://github.com/braboj) — [Imbra.io](https://imbra.io)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbraboj%2Fsolid-ai-templates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbraboj%2Fsolid-ai-templates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbraboj%2Fsolid-ai-templates/lists"}