[{"data":1,"prerenderedAt":499},["ShallowReactive",2],{"skill-en":3},{"id":4,"title":5,"attribution":6,"body":7,"definition":489,"description":490,"extension":491,"eyebrow":492,"meta":493,"navigation":494,"path":495,"seo":496,"stem":497,"__hash__":498},"docs\u002Fen\u002Fskill.md","The Context Architecture skill, run it with your agent",null,{"type":8,"value":9,"toc":475},"minimark",[10,25,28,33,67,70,74,87,115,134,139,165,172,206,217,221,232,259,266,270,277,304,311,315,342,349,353,356,403,407,410,424,427,431,434,440,446,450,471],[11,12,13,14,19,20,24],"p",{},"The skill is the specification, turned into something your agent runs. One Markdown file. You load it,\npoint it at a repo, and it reads the code as a reader with no memory, audits it against the\n",[15,16,18],"a",{"href":17},"\u002F","eight principles",", and tells you where that reader would have to guess. Then it hands back the\nbacklog in the order the ",[15,21,23],{"href":22},"\u002Fguide","guide"," lays out.",[11,26,27],{},"No server, no dependency, no special tooling. It is a file your agent reads, which is principle 06\n(Capabilities Are Discoverable) applied to the skill itself.",[29,30,32],"h2",{"id":31},"what-it-does","What it does",[34,35,36,44,50,56],"ul",{},[37,38,39,43],"li",{},[40,41,42],"strong",{},"Audits"," the repo against the eight principles and the five failure modes, and writes a report\nwith a verdict and the evidence behind it, one per principle.",[37,45,46,49],{},[40,47,48],{},"Finds context-rot",": docs that cite deleted files, name renamed modules, or contradict the code.",[37,51,52,55],{},[40,53,54],{},"Proposes a backlog",": PR-sized changes ordered by leverage, each paired with the check (lint,\ntypes, test, review) that keeps its claim honest.",[37,57,58,66],{},[40,59,60,61,65],{},"Drafts ",[62,63,64],"code",{},"AGENTS.md"," files"," at the boundaries, holding only what you cannot get from the code.",[11,68,69],{},"It works on code that already exists and grew messy. It does not scaffold new projects.",[29,71,73],{"id":72},"install-it","Install it",[11,75,76,77,86],{},"One command covers most tools. The ",[15,78,82,85],{"href":79,"rel":80},"https:\u002F\u002Fskills.sh",[81],"nofollow",[62,83,84],{},"skills"," CLI"," reads the skill from the repo and\ndrops it into whatever agent you have:",[88,89,94],"pre",{"className":90,"code":91,"language":92,"meta":93,"style":93},"language-bash shiki shiki-themes material-theme-lighter github-light github-dark","npx skills add sergioazoc\u002Fcontext-architecture\n","bash","",[62,95,96],{"__ignoreMap":93},[97,98,101,105,109,112],"span",{"class":99,"line":100},"line",1,[97,102,104],{"class":103},"sbgvK","npx",[97,106,108],{"class":107},"s_sjI"," skills",[97,110,111],{"class":107}," add",[97,113,114],{"class":107}," sergioazoc\u002Fcontext-architecture\n",[11,116,117,118,121,122,125,126,129,130,133],{},"It asks which tool to install into. Pass ",[62,119,120],{},"-a \u003Ctool>"," to pick one (for example ",[62,123,124],{},"-a claude-code","), ",[62,127,128],{},"-g","\nto install it for all your projects, and ",[62,131,132],{},"-y"," to skip the prompts. The per-tool sections below cover\nthe manual path if you would rather drop the file in yourself, or your tool is not on its list.",[135,136,138],"h3",{"id":137},"claude-code","Claude Code",[88,140,142],{"className":90,"code":141,"language":92,"meta":93,"style":93},"npx skills add sergioazoc\u002Fcontext-architecture -a claude-code -g\n",[62,143,144],{"__ignoreMap":93},[97,145,146,148,150,152,155,159,162],{"class":99,"line":100},[97,147,104],{"class":103},[97,149,108],{"class":107},[97,151,111],{"class":107},[97,153,154],{"class":107}," sergioazoc\u002Fcontext-architecture",[97,156,158],{"class":157},"stzsN"," -a",[97,160,161],{"class":107}," claude-code",[97,163,164],{"class":157}," -g\n",[11,166,167,168,171],{},"By hand, with no Node: save the file into a folder named for the skill, then restart Claude Code. The\nfolder name is what you type as the ",[62,169,170],{},"\u002Fcontext-architecture"," command, so keep it exactly that.",[88,173,175],{"className":90,"code":174,"language":92,"meta":93,"style":93},"mkdir -p ~\u002F.claude\u002Fskills\u002Fcontext-architecture\ncurl -fsSL https:\u002F\u002Fcontext-architecture.dev\u002Fskill.md -o ~\u002F.claude\u002Fskills\u002Fcontext-architecture\u002FSKILL.md\n",[62,176,177,188],{"__ignoreMap":93},[97,178,179,182,185],{"class":99,"line":100},[97,180,181],{"class":103},"mkdir",[97,183,184],{"class":157}," -p",[97,186,187],{"class":107}," ~\u002F.claude\u002Fskills\u002Fcontext-architecture\n",[97,189,191,194,197,200,203],{"class":99,"line":190},2,[97,192,193],{"class":103},"curl",[97,195,196],{"class":157}," -fsSL",[97,198,199],{"class":107}," https:\u002F\u002Fcontext-architecture.dev\u002Fskill.md",[97,201,202],{"class":157}," -o",[97,204,205],{"class":107}," ~\u002F.claude\u002Fskills\u002Fcontext-architecture\u002FSKILL.md\n",[11,207,208,209,212,213,216],{},"Drop the ",[62,210,211],{},"~\u002F.claude"," for a personal install; use ",[62,214,215],{},".claude\u002Fskills\u002Fcontext-architecture\u002FSKILL.md"," to\nscope it to one project instead.",[135,218,220],{"id":219},"cursor","Cursor",[11,222,223,224,227,228,231],{},"Save it as a project rule. The ",[62,225,226],{},".mdc"," extension matters, a plain ",[62,229,230],{},".md"," in that folder is ignored:",[88,233,235],{"className":90,"code":234,"language":92,"meta":93,"style":93},"mkdir -p .cursor\u002Frules\ncurl -fsSL https:\u002F\u002Fcontext-architecture.dev\u002Fskill.md -o .cursor\u002Frules\u002Fcontext-architecture.mdc\n",[62,236,237,246],{"__ignoreMap":93},[97,238,239,241,243],{"class":99,"line":100},[97,240,181],{"class":103},[97,242,184],{"class":157},[97,244,245],{"class":107}," .cursor\u002Frules\n",[97,247,248,250,252,254,256],{"class":99,"line":190},[97,249,193],{"class":103},[97,251,196],{"class":157},[97,253,199],{"class":107},[97,255,202],{"class":157},[97,257,258],{"class":107}," .cursor\u002Frules\u002Fcontext-architecture.mdc\n",[11,260,261,262,265],{},"The skill's ",[62,263,264],{},"description"," frontmatter tells Cursor to pull the rule in when it is relevant.",[135,267,269],{"id":268},"github-copilot-vs-code","GitHub Copilot (VS Code)",[11,271,272,273,276],{},"VS Code reads Agent Skills natively, the same ",[62,274,275],{},"SKILL.md"," format. The folder must be named for the\nskill, or Copilot will not load it:",[88,278,280],{"className":90,"code":279,"language":92,"meta":93,"style":93},"mkdir -p .github\u002Fskills\u002Fcontext-architecture\ncurl -fsSL https:\u002F\u002Fcontext-architecture.dev\u002Fskill.md -o .github\u002Fskills\u002Fcontext-architecture\u002FSKILL.md\n",[62,281,282,291],{"__ignoreMap":93},[97,283,284,286,288],{"class":99,"line":100},[97,285,181],{"class":103},[97,287,184],{"class":157},[97,289,290],{"class":107}," .github\u002Fskills\u002Fcontext-architecture\n",[97,292,293,295,297,299,301],{"class":99,"line":190},[97,294,193],{"class":103},[97,296,196],{"class":157},[97,298,199],{"class":107},[97,300,202],{"class":157},[97,302,303],{"class":107}," .github\u002Fskills\u002Fcontext-architecture\u002FSKILL.md\n",[11,305,306,307,310],{},"On JetBrains, or older Copilot without skills, paste the file into ",[62,308,309],{},".github\u002Fcopilot-instructions.md","\ninstead.",[135,312,314],{"id":313},"openai-codex","OpenAI Codex",[88,316,318],{"className":90,"code":317,"language":92,"meta":93,"style":93},"mkdir -p ~\u002F.agents\u002Fskills\u002Fcontext-architecture\ncurl -fsSL https:\u002F\u002Fcontext-architecture.dev\u002Fskill.md -o ~\u002F.agents\u002Fskills\u002Fcontext-architecture\u002FSKILL.md\n",[62,319,320,329],{"__ignoreMap":93},[97,321,322,324,326],{"class":99,"line":100},[97,323,181],{"class":103},[97,325,184],{"class":157},[97,327,328],{"class":107}," ~\u002F.agents\u002Fskills\u002Fcontext-architecture\n",[97,330,331,333,335,337,339],{"class":99,"line":190},[97,332,193],{"class":103},[97,334,196],{"class":157},[97,336,199],{"class":107},[97,338,202],{"class":157},[97,340,341],{"class":107}," ~\u002F.agents\u002Fskills\u002Fcontext-architecture\u002FSKILL.md\n",[11,343,344,345,348],{},"Use a project-local ",[62,346,347],{},".agents\u002Fskills\u002Fcontext-architecture\u002FSKILL.md"," to scope it to one repo. Restart\nCodex if it does not pick the skill up.",[135,350,352],{"id":351},"other-tools","Other tools",[11,354,355],{},"Same idea: the file goes where the tool reads its rules.",[34,357,358,368,377,390],{},[37,359,360,363,364,367],{},[40,361,362],{},"Windsurf",": ",[62,365,366],{},".windsurf\u002Frules\u002Fcontext-architecture.md",". If Windsurf complains about size, point it\nat the file instead of pasting the whole thing.",[37,369,370,363,373,376],{},[40,371,372],{},"Cline",[62,374,375],{},".clinerules\u002Fcontext-architecture.md",".",[37,378,379,382,383,385,386,389],{},[40,380,381],{},"Zed",": append it to your ",[62,384,64],{},", which Zed reads. A loose ",[62,387,388],{},".rules"," file can shadow an existing\none, so appending is safer.",[37,391,392,395,396,399,400,376],{},[40,393,394],{},"Aider",": save it as ",[62,397,398],{},"CONVENTIONS.md",", then run ",[62,401,402],{},"aider --read CONVENTIONS.md",[135,404,406],{"id":405},"any-other-agent","Any other agent",[11,408,409],{},"Grab the raw file and paste it into your tool's instructions, or point the tool at it:",[88,411,413],{"className":90,"code":412,"language":92,"meta":93,"style":93},"curl -fsSL https:\u002F\u002Fcontext-architecture.dev\u002Fskill.md\n",[62,414,415],{"__ignoreMap":93},[97,416,417,419,421],{"class":99,"line":100},[97,418,193],{"class":103},[97,420,196],{"class":157},[97,422,423],{"class":107}," https:\u002F\u002Fcontext-architecture.dev\u002Fskill.md\n",[11,425,426],{},"It is self-contained. It restates the rule, the eight principles, and the five failure modes, so it\nworks with no way back to this site.",[29,428,430],{"id":429},"use-it","Use it",[11,432,433],{},"Load the skill and point your agent at a repo:",[435,436,437],"blockquote",{},[11,438,439],{},"Apply the Context Architecture skill to this repository.",[11,441,442,443,445],{},"It writes the audit first, read-only, then the ordered backlog. Work it one change at a time, each\nlanding with the check that keeps its claim from rotting. Start where it tells you to: the docs that\nlie, and the ",[62,444,64],{}," files at the top boundaries. That is where you get the most back per edit.",[29,447,449],{"id":448},"where-to-go-next","Where to go next",[34,451,452,459,464],{},[37,453,454,455,458],{},"The ",[15,456,457],{"href":17},"specification",": the rule, the four pillars, the mechanism, and the eight principles.",[37,460,454,461,463],{},[15,462,23],{"href":22},": the same work, done by hand, step by step.",[37,465,454,466,470],{},[15,467,469],{"href":468},"\u002Fglossary","glossary",": the terms the skill uses, defined.",[472,473,474],"style",{},"html pre.shiki code .sbgvK, html code.shiki .sbgvK{--shiki-light:#E2931D;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .s_sjI, html code.shiki .s_sjI{--shiki-light:#91B859;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .stzsN, html code.shiki .stzsN{--shiki-light:#91B859;--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":93,"searchDepth":190,"depth":190,"links":476},[477,478,487,488],{"id":31,"depth":190,"text":32},{"id":72,"depth":190,"text":73,"children":479},[480,482,483,484,485,486],{"id":137,"depth":481,"text":138},3,{"id":219,"depth":481,"text":220},{"id":268,"depth":481,"text":269},{"id":313,"depth":481,"text":314},{"id":351,"depth":481,"text":352},{"id":405,"depth":481,"text":406},{"id":429,"depth":190,"text":430},{"id":448,"depth":190,"text":449},"The Context Architecture skill is an agent-agnostic procedure that reads an existing repository as a cold reader, audits it against the eight principles, finds the documentation that lies, and hands back an ordered backlog of fixes. It needs no server. The install is one file your agent reads.","An agent-agnostic skill that audits an existing codebase against the eight principles of Context Architecture, finds the docs that lie, and hands back a backlog of fixes. One command installs it into Claude Code, Cursor, Codex, Copilot, and more. By Sergio Azócar.","md","Skill",{},true,"\u002Fen\u002Fskill",{"title":5,"description":490},"en\u002Fskill","ku9jrGRe3oFksGFfkEOaLg-qxe2ZeTCMx5Wuyq7GG5Y",1781920627983]