{"id":49509639,"url":"https://github.com/fjoelnr/ai-native-repo-template","last_synced_at":"2026-05-01T18:35:23.673Z","repository":{"id":342784495,"uuid":"1175163333","full_name":"fjoelnr/ai-native-repo-template","owner":"fjoelnr","description":"Template for AI Native Repositories with ANR structure, AGENTS.md context and validation workflows.","archived":false,"fork":false,"pushed_at":"2026-03-23T21:53:21.000Z","size":178,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2026-03-24T20:16:24.773Z","etag":null,"topics":["ai-native","anr","template"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fjoelnr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2026-03-07T10:16:04.000Z","updated_at":"2026-03-23T21:50:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fjoelnr/ai-native-repo-template","commit_stats":null,"previous_names":["fjoelnr/ai-native-repo-template"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/fjoelnr/ai-native-repo-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjoelnr%2Fai-native-repo-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjoelnr%2Fai-native-repo-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjoelnr%2Fai-native-repo-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjoelnr%2Fai-native-repo-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fjoelnr","download_url":"https://codeload.github.com/fjoelnr/ai-native-repo-template/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fjoelnr%2Fai-native-repo-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32508910,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"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":["ai-native","anr","template"],"created_at":"2026-05-01T18:35:23.085Z","updated_at":"2026-05-01T18:35:23.663Z","avatar_url":"https://github.com/fjoelnr.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Native Repositories\n\nRepositories were built for humans.  \nANR makes them readable for agents.\n\n![ANR Standard](https://img.shields.io/badge/ANR-Standard-blue)\n![ANR Level](https://img.shields.io/badge/ANR%20Level-1-green)\n![Migration Ready](https://img.shields.io/badge/Migration-Ready-orange)\n![ANR Validation](https://img.shields.io/badge/ANR%20Validation-pending-lightgrey)\n\nMost people treat `AGENTS.md` like a prompt file.\n\nThat is the mistake.\n\nIf you want an AI coding agent to feel like a senior engineer living inside your repository, the repository needs structure.\n\nANR is that structure.\n\n## What This Repository Is For\n\nUse this template when you want a new repository to be:\n\n- readable for both humans and coding agents\n- migration-ready for ANR from day one\n- opinionated enough to give agents guardrails without hardcoding your product domain\n- extensible through stack profiles instead of vendor-specific prompt packs\n\nThis repository is not a finished product scaffold for a specific stack.\nIt is a reference template for repository structure, context layering, and AI-native operating conventions.\n\n## The Core Idea\n\nAn effective agent needs four things at all times:\n\n- the why -\u003e what the system does\n- the map -\u003e where things live\n- the rules -\u003e what is allowed and what is not\n- the workflows -\u003e how work gets done\n\nPrompting is temporary.  \nStructure is permanent.\n\n`README.md` explains a project to humans.  \n`AGENTS.md` explains it to AI.\n\n## The Anatomy of an AI Native Repository\n\n- `AGENTS.md` -\u003e repo memory\n- `.agents/context-index.md` -\u003e repository map\n- local `AGENT.md` files -\u003e context near risky modules\n- `.agents/skills/` -\u003e reusable expert modes\n- `.agents/workflows/` -\u003e development procedures\n- `.agents/guardrails/` -\u003e deterministic boundaries\n- `docs/` -\u003e progressive source of truth\n- `profiles/` -\u003e stack-specific overlays for common repository families\n- `anr.yaml` -\u003e machine-readable repository manifest\n\nANR builds on `AGENTS.md` and turns it into a full repository architecture for AI agents.\n\n## ANR Reference Architecture\n\n```text\n                           AI Coding Agents\n               (Codex, Cursor, Copilot, Claude, ...)\n                                  |\n                         +--------v--------+\n                         |    AGENTS.md    |\n                         |  Repo Memory    |\n                         +--------+--------+\n                                  |\n                         +--------v--------+\n                         | .agents/context |\n                         |    -index.md    |\n                         +--------+--------+\n                                  |\n         +------------------------+------------------------+\n         |                        |                        |\n   +-----v------+           +-----v------+           +-----v------+\n   | src/AGENT.md|          |tests/AGENT.md|         |docs/AGENT.md|\n   +-----+------+           +-----+------+           +-----+------+\n         |                        |                        |\n         +------------------------+------------------------+\n                                  |\n        +-------------------------+-------------------------+\n        |                         |                         |\n +------v---------+      +--------v--------+      +--------v--------+\n | .agents/skills |      |.agents/workflows|      |.agents/guardrails|\n +----------------+      +-----------------+      +-----------------+\n                                  |\n                         +--------v--------+\n                         |    anr.yaml     |\n                         | Machine Metadata|\n                         +-----------------+\n```\n\n## From Traditional Repository to AI Native Repository\n\n```text\nTraditional Repository                           AI Native Repository\n----------------------                           --------------------\nREADME.md as primary guide                       README.md + AGENTS.md\nimplicit team knowledge                          explicit context layer\nad-hoc prompts per task                          reusable skills/workflows\nunclear edit boundaries                          versioned guardrails\n\n                    Transform\n     \"Migrate this repository to ANR\"\n```\n\n## Why This Matters\n\nWhen a repository is organized this way, an agent stops behaving like a chatbot and starts behaving more like a project-native engineer.\n\nThe important change is not the model.\nIt is the repository becoming an operating environment for the model.\n\n## Existing Repositories, Not Just New Ones\n\nMost production repositories already exist.\nANR is designed for migration, not just greenfield setup.\n\nMigration workflow:\n\n- [.agents/workflows/migrate-repository-to-anr.md](.agents/workflows/migrate-repository-to-anr.md)\n\nTypical prompt:\n\n`Convert this repository to ANR.`\n\nExpected migration sequence:\n\n1. inspect the current structure\n2. generate `AGENTS.md`\n3. create `.agents/context-index.md`\n4. add local `AGENT.md` files near sharp edges\n5. define workflows and guardrails\n6. validate ANR compliance\n\n## Quickstart\n\n```bash\ngit clone \u003ctemplate-repo\u003e my-project\ncd my-project\nnode tools/anr-cli/index.js init\nnode tools/anr-cli/index.js apply-profile startup-os\nnode tools/anr-cli/index.js validate\n```\n\nThen choose a stack profile from `profiles/`, apply it if it fits, install extra packs only when needed, and start implementing your domain in `src/`.\n\n## Template Adoption Checklist\n\nAfter creating a new repository from this template:\n\n1. replace the project name, description, and badges in `README.md`\n2. update `AGENTS.md` with the real repository purpose and map\n3. keep or remove example material under `examples/` depending on whether it helps the target repo\n4. choose the closest stack profile from `profiles/` and merge only the relevant guidance\n5. add stack-specific workflows, guardrails, and local `AGENT.md` files where complexity actually exists\n6. set `CODEOWNERS`, repository topics, and CI to match the real project\n7. validate the resulting structure before writing feature code\n\n## Current Status\n\n- ANR reference template: active\n- intended use: greenfield repositories and migration experiments\n- validation workflow: `.github/workflows/anr-validate.yml`\n- current default branch flow: `feature -\u003e develop -\u003e main`\n\n## Key Links\n\n- ANR Spec: [AI_NATIVE_REPO_SPEC.md](AI_NATIVE_REPO_SPEC.md)\n- Example Project: [examples/basic-anr-project](examples/basic-anr-project)\n- Migration Workflow: [.agents/workflows/migrate-repository-to-anr.md](.agents/workflows/migrate-repository-to-anr.md)\n- Stack Profiles: [docs/stack-profiles.md](docs/stack-profiles.md)\n- Profiles Directory: [profiles/README.md](profiles/README.md)\n- ANR Manifest: [anr.yaml](anr.yaml)\n- Related Work: [docs/related-work.md](docs/related-work.md)\n- ANR Evolution: [docs/anr-evolution.md](docs/anr-evolution.md)\n- ANR v0.2 Proposal: [docs/anr-v0.2-spec.md](docs/anr-v0.2-spec.md)\n- Agentic Patterns Mapping: [docs/agentic-patterns-mapping.md](docs/agentic-patterns-mapping.md)\n- Positioning: [docs/anr-positioning.md](docs/anr-positioning.md)\n- Status: [docs/STATUS.md](docs/STATUS.md)\n- Research: [docs/research.md](docs/research.md)\n- Ecosystem Registry: [registry/README.md](registry/README.md)\n\n## Reference Implementation\n\nThis repository includes a minimal ANR reference implementation:\n\n- Example repository: [examples/basic-anr-project](examples/basic-anr-project)\n- Pattern lab seed: [examples/agentic-patterns-lab](examples/agentic-patterns-lab)\n- Machine-readable manifest: [anr.yaml](anr.yaml)\n\n## Relationship to AGENTS.md\n\n- `AGENTS.md` -\u003e single instruction file\n- `ANR` -\u003e full repository architecture\n\n## Relationship to MCP\n\n- `ANR` -\u003e repository interface\n- `MCP` -\u003e tool interface\n\nTogether:\n\n```text\nAI Agent\n   |\nANR (repository interface)\n   |\nMCP (tool interface)\n   |\ntools and services\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffjoelnr%2Fai-native-repo-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffjoelnr%2Fai-native-repo-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffjoelnr%2Fai-native-repo-template/lists"}