{"id":51413926,"url":"https://github.com/sergioazoc/context-architecture","last_synced_at":"2026-07-04T17:02:39.648Z","repository":{"id":365611317,"uuid":"1085275447","full_name":"sergioazoc/context-architecture","owner":"sergioazoc","description":"Context Architecture is the practice of structuring a codebase so that its intent and behavior are equally legible to people and AI agents. It treats the repository (its file tree, boundaries, conventions, and embedded context) as a designed artifact.","archived":false,"fork":false,"pushed_at":"2026-06-27T22:12:29.000Z","size":740,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-27T23:19:16.695Z","etag":null,"topics":["agents-md","ai-agents","ai-coding","claude-code","context-architecture","context-engineering","llm","screaming-architecture","software-architecture","spec-driven-development"],"latest_commit_sha":null,"homepage":"https://context-architecture.dev/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sergioazoc.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-28T20:19:41.000Z","updated_at":"2026-06-27T22:12:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sergioazoc/context-architecture","commit_stats":null,"previous_names":["sergioazoc/context-architecture"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sergioazoc/context-architecture","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergioazoc%2Fcontext-architecture","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergioazoc%2Fcontext-architecture/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergioazoc%2Fcontext-architecture/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergioazoc%2Fcontext-architecture/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sergioazoc","download_url":"https://codeload.github.com/sergioazoc/context-architecture/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergioazoc%2Fcontext-architecture/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35129190,"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-04T02:00:05.987Z","response_time":113,"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":["agents-md","ai-agents","ai-coding","claude-code","context-architecture","context-engineering","llm","screaming-architecture","software-architecture","spec-driven-development"],"created_at":"2026-07-04T17:02:38.871Z","updated_at":"2026-07-04T17:02:39.630Z","avatar_url":"https://github.com/sergioazoc.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# context-architecture.dev\n\nThe canonical site for **Context Architecture**: a software architecture for the age of AI agents. It\nstructures a repository so everything it claims about itself, its structure, its behavior, and who can\nchange it, is legible to the agent writing the code and to the people who answer for it, and bound to a\nmechanism that fails when the claim stops being true. Introduced by\n[Sergio Azócar](https://sergioazocar.com) in October 2025.\n\nThis repository is its own first case study. If you arrived here from the manifesto to check whether\nthe author structures projects the way he argues for, this README and the `AGENTS.md` files are the\nanswer. The structure is the argument.\n\n## What this is\n\nA small, dense, prerendered specification site. Not a product landing page. It reads as an RFC:\ntypography, structure, and almost nothing else.\n\n- **Two readers, one source.** Every page can be read as a typeset document (person view) or as the\n  raw Markdown an agent consumes (agent view). Both come from the same `.md` file. The site\n  demonstrates its own thesis.\n- **Static by design.** Fully prerendered (SSG); all content is in the served HTML, with no\n  dependency on JavaScript for crawlers and LLMs to read it.\n\n## Apply it\n\nContext Architecture applies both to a repository born legible from the first commit and to one that\nalready grew without design. To apply it:\n\n- Read the [specification](https://context-architecture.dev) and the\n  [step-by-step guide](https://context-architecture.dev/guide).\n- Install the agent skill into your tool with one command, `npx skills add sergioazoc/context-architecture`\n  (Claude Code, Cursor, Codex, Copilot, and more), or copy\n  [`skills/context-architecture/SKILL.md`](./skills/context-architecture/SKILL.md) / fetch the raw file at\n  [`context-architecture.dev/skill.md`](https://context-architecture.dev/skill.md). The\n  [skill page](https://context-architecture.dev/skill) has per-tool install and update steps.\n\n## Structure\n\nThe top level screams what the project _is_, not which framework built it:\n\n```text\ncontent/            # the manifesto: source of truth, one file per locale\n  en/  es/          # /, /comparison, /guide, /glossary, /skill\napp/\n  pages/            # one file per route; queries content, renders it\n  components/       # layout shell, person/agent toggle, MDC blocks (rule, diagrams)\n  composables/      # site metadata, structured data (manifesto + glossary schema)\n  app.config.ts     # Nuxt UI theme: palette + prose reading typography\n  assets/css/       # design tokens + global base (UI strings live in each component's \u003ci18n\u003e)\nskills/             # the distributable skill (context-architecture/SKILL.md)\nserver/             # one prerendered route: /skill.md serves the raw skill\n```\n\nSpecs are design-time only (principle 06): written before code, turned into code, tests, and the\nrelevant `AGENTS.md`, then removed. The site's own spec was already turned into the files above, so\nthere is no `specs/` directory to keep.\n\n## Develop\n\n```bash\npnpm install\npnpm dev          # http://localhost:3000\n```\n\n## Quality\n\nConventions are codified, not tribal (principle 07). The CSS conventions are machine-checked by\n`oxlint` with the `oxlint-tailwindcss` plugin:\n\n```bash\npnpm lint         # oxlint + oxlint-tailwindcss\npnpm typecheck    # vue-tsc\npnpm test         # vitest: the repo's claims about itself, bound\npnpm format       # oxfmt (formats code; Markdown is excluded, it reflows MDC blocks)\npnpm format:check # oxfmt --check (the CI gate that fails on unformatted code)\n```\n\n## Build \u0026 deploy\n\nStatic generation, deployed to Cloudflare Workers as static assets:\n\n```bash\npnpm generate     # prerender to .output/public\npnpm deploy       # generate \u0026\u0026 wrangler deploy\n```\n\n## License\n\n- **Manifesto content** (`content/`): [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/),\n  see [`LICENSE`](./LICENSE).\n- **Code**: MIT.\n\nThe nine principles in the manifesto are the author's methodology.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergioazoc%2Fcontext-architecture","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsergioazoc%2Fcontext-architecture","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergioazoc%2Fcontext-architecture/lists"}