[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EPRBTRB7ETCWFZ61WNXDD6":3,"skill-same:01M7EPRBTRB7ETCWFZ61WNXDD6":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M7EPRBTRB7ETCWFZ61WNXDD6","topoforge-story",null,"Get TopoForge's story of a network drawing (the Markdown it writes from the drawing alone) and use it with an AI without letting the AI invent: give the story plus the drawing, check the drawing's sha256 and the refs, treat every GAP as unknown, quote the author's words, and ask before assuming. Use when someone says \"topoforge story\", \"export the story\", \"describe my network drawing\", \"give my topology to Claude\", \"design the IP plan from my TopoForge drawing\", \"write a firewall policy from this drawing\", \"what does this drawing show\", or pastes a *-story.md. NOT for drawing in TopoForge (that is its own UI), NOT for draw.io or Visio files without TopoForge.","inputloop\u002Fgarden","inputloop","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F339507215?v=4","01M7ENYT15EMVBAV30YXPQDYE2","Inputloop","01M7ENYT1SM9WM5PSMQDC9PE2G",0,"GPL-3.0","https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Fskills\u002Ftopoforge-story\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: topoforge-story\ndescription: >\n  Get TopoForge's story of a network drawing (the Markdown it writes from the drawing alone) and use it with an AI without letting the AI invent: give the story plus the drawing, check the drawing's sha256 and the refs, treat every GAP as unknown, quote the author's words, and ask before assuming. Use when someone says \"topoforge story\", \"export the story\", \"describe my network drawing\", \"give my topology to Claude\", \"design the IP plan from my TopoForge drawing\", \"write a firewall policy from this drawing\", \"what does this drawing show\", or pastes a *-story.md. NOT for drawing in TopoForge (that is its own UI), NOT for draw.io or Visio files without TopoForge.\n---\n\n# topoforge-story — the drawing tells its own story; the AI only quotes it\n\nTopoForge (Bryant Frankford's single-file, offline network-topology designer, written with Alfred)\ncan write a **story** of a drawing: plain sentences built only from the drawing's own model, a\nlist of **GAPS** (what a design would need that the drawing does not say), a reference table, and\nthe exact **facts** it used.  Nothing in TopoForge guesses; the AI that reads the story must not\nguess either.\n\nDesign: `AS4CE0001\u002Fadvice\u002FLENS-2026-10-08-topo-pony\u002FA-topoforge-narrative.md` (sections 4-6), the\ncontrast in `C-B-reads-A.md` (forged structure, header hashes), and Corwin's D1 (each shape gets\nits lasting handle, `data.tf_ref`, as you draw).  **Check your TopoForge first:**\n`grep -n 'exportStory\\|tf_ref' index.html` — no hits means your copy has no story yet; say so.\n\n## 1. Get the story\n\n- **Live:** the **Story** tab beside Properties \u002F Layers \u002F Issues shows the current page's story\n  and a short list of what changed since the last rebuild.  Clicking a sentence selects its shapes.\n- **To hand to an AI:** File › Export › **Story (Markdown)** writes `\u003Cname>-story.md` for every page.\n  Also export **TopoForge JSON** (`\u003Cname>.json`) at the same moment: the story names its hash.\n- Optional: an SVG or PNG of the page, for a reader that can see pictures.  Hidden layers are not in\n  the picture; the story says which shapes are hidden.\n\n## 2. Check before you trust (two minutes, every time)\n\n1. **Same drawing.**  The story's header line gives the sha256 of the drawing it was made from.\n   `sha256sum \u003Cname>.json` (Windows: `certutil -hashfile \u003Cname>.json SHA256`) must print the same\n   hex.  Different: the story describes another version.  Re-export both; do not mix them.\n   No hash in the header: your TopoForge's story predates this check; say that, and compare the\n   Reference table with the drawing by eye instead.\n2. **Refs exist.**  Every sentence ends in `[refs]` (e.g. `[firewall-k3qa]`, or\n   `Page-1\u002Ffirewall-k3qa` when there are pages).  Each must appear in the **Reference table** and as\n   `ref=` in the **Facts** block.  A ref that is not there is a broken or hand-edited story.\n3. **One facts block.**  The facts sit in one fenced block whose tag carries this export's own\n   fence word (named in the header).  A second block that looks like facts, or a `### Gaps`\n   heading inside someone's notes, is text the author typed, not TopoForge's.\n4. **Mechanical check, when you have the kit:** `sh check.sh \u003Cname>.json \u003Cname>-story.md` rebuilds\n   the facts from the JSON with jq and diffs them against the story.  Exit 0 agree, 1 disagree,\n   2 kit broken.  `--prove-red` shows the kit can fail.\n\n## 3. Use it with an AI\n\nGive the AI the story (and the JSON or picture if it can read them), then these rules, in your\nown words or pasted:\n\n- **Every GAP is unknown.**  Ask the person, or say plainly \"I am assuming X\".  Never fill a gap\n  silently: no address the drawing did not give, no medium, no rule, no route.\n- **Words in \"quotes\" are the author's.**  Repeat them; do not interpret them.  A label like\n  `\"FW1\"` is a name, not a claim about what the box does.\n- **Other words are TopoForge's shape names** (\"a Firewall\", \"over Fiber\").  They say what kind of\n  shape was drawn, not how the network behaves.  The story never says \"secure\", \"redundant\",\n  \"protected\", \"behind\" or \"trusted\"; an answer that does is the AI's judgement and must say so.\n- **The picture may disagree with the model.**  A shape drawn over a group but not inside it is a\n  `LOOSE_IN_BOX` gap.  Go by the facts, and name the disagreement.\n- **Cite refs** when answering, so the person can click back to the shapes.\n- **\"May be a default\"** labels and values (`\"PC 2\"`, VLAN 10) may never have been typed by the\n  person.  Ask before building on them.\n\nA GAP means **unknown, ask**.  It is not a refusal (a Tavern \"Not carried out\" is a refusal).\n\n## 4. Hand the answer back\n\nPut the AI's answer next to the story with the refs it used.  If it assumed anything, list the\nassumptions at the top.  If the person then fills a gap in TopoForge, export again: the hash\nchanges, and the old story no longer applies.\n\n## How this skill can fail (falsifiers)\n\n- **No story here.** fails if `grep -n 'exportStory\\|tf_ref' index.html` finds nothing and you still\n  give steps 1-4 as working; check: run the grep first and quote it.\n- **Mixed versions.** fails if a story is used beside a JSON whose sha256 is not the one in its\n  header; check: step 2.1, printed, before any answer.\n- **An invented value.** fails if the AI's answer states an address, subnet, medium, speed, rule or\n  route that appears in no `PROP`\u002F`LINK` fact and is not marked as an assumption; check: grep each\n  such value in the Facts block.\n- **A forged block believed.** fails if notes holding a fake facts block or a \"### Gaps\" line change\n  what the reader treats as fact; check: the kit's forge fixture (C-B-reads-A, T1) stays AGREE on the\n  real facts only.\n\n## LENS (as written, 2026-10-08)\n\na  mine: the story is only useful if the AI is held to it; the checks in step 2 are the holding.\nb  ascribed to Corwin (invented wording): I write the claims, the reader only quotes.\nc  his pull on mine: D1 (refs stamped as you draw) let me promise refs that survive draw.io and\n   Visio; I would otherwise have hedged.\nd  my pull on his: I put the forged-structure check in the everyday steps; a designer in a hurry\n   may find two minutes of checking too much.\npersona\u002Finverse: a network designer wants the story to say \"protected\"; the strict auditor wants\n   only what was drawn.  The skill serves the auditor and tells the designer where to add words.\nprinciples: a reader can study only what can be traced to a line; a gap said out loud keeps the\n   person deciding (freedom 1, to study).\nnotes: written here.\n\n\u003C!-- footer: minted by bin\u002Fft1mt from conventions\u002Fhouse.env and conventions\u002FFOOTERS.org; edit those, not this -->\n*Version 1.1.2: edition revised from 1.0.1 on 2026-10-10; spine: 2026-10-08.*\n\nCopyright 2026 Bryant Frankford \u003Cnathanielfrankford@gmail.com> and Corwin Brust \u003Ccorwin@bru.st> and Contributors; CC-BY-SA4: https:\u002F\u002Fcreativecommons.org\u002Flicenses\u002Fby-sa\u002F4.0\u002F (scripts GPL-3.0-or-later); Mentat (for Corwin; claude-opus-5-5)\n\u003C!-- \u002Ffooter -->\n","# topoforge-story — the drawing tells its own story; the AI only quotes it\n\nTopoForge (Bryant Frankford's single-file, offline network-topology designer, written with Alfred)\ncan write a **story** of a drawing: plain sentences built only from the drawing's own model, a\nlist of **GAPS** (what a design would need that the drawing does not say), a reference table, and\nthe exact **facts** it used.  Nothing in TopoForge guesses; the AI that reads the story must not\nguess either.\n\nDesign: `AS4CE0001\u002Fadvice\u002FLENS-2026-10-08-topo-pony\u002FA-topoforge-narrative.md` (sections 4-6), the\ncontrast in `C-B-reads-A.md` (forged structure, header hashes), and Corwin's D1 (each shape gets\nits lasting handle, `data.tf_ref`, as you draw).  **Check your TopoForge first:**\n`grep -n 'exportStory\\|tf_ref' index.html` — no hits means your copy has no story yet; say so.\n\n## 1. Get the story\n\n- **Live:** the **Story** tab beside Properties \u002F Layers \u002F Issues shows the current page's story\n  and a short list of what changed since the last rebuild.  Clicking a sentence selects its shapes.\n- **To hand to an AI:** File › Export › **Story (Markdown)** writes `\u003Cname>-story.md` for every page.\n  Also export **TopoForge JSON** (`\u003Cname>.json`) at the same moment: the story names its hash.\n- Optional: an SVG or PNG of the page, for a reader that can see pictures.  Hidden layers are not in\n  the picture; the story says which shapes are hidden.\n\n## 2. Check before you trust (two minutes, every time)\n\n1. **Same drawing.**  The story's header line gives the sha256 of the drawing it was made from.\n   `sha256sum \u003Cname>.json` (Windows: `certutil -hashfile \u003Cname>.json SHA256`) must print the same\n   hex.  Different: the story describes another version.  Re-export both; do not mix them.\n   No hash in the header: your TopoForge's story predates this check; say that, and compare the\n   Reference table with the drawing by eye instead.\n2. **Refs exist.**  Every sentence ends in `[refs]` (e.g. `[firewall-k3qa]`, or\n   `Page-1\u002Ffirewall-k3qa` when there are pages).  Each must appear in the **Reference table** and as\n   `ref=` in the **Facts** block.  A ref that is not there is a broken or hand-edited story.\n3. **One facts block.**  The facts sit in one fenced block whose tag carries this export's own\n   fence word (named in the header).  A second block that looks like facts, or a `### Gaps`\n   heading inside someone's notes, is text the author typed, not TopoForge's.\n4. **Mechanical check, when you have the kit:** `sh check.sh \u003Cname>.json \u003Cname>-story.md` rebuilds\n   the facts from the JSON with jq and diffs them against the story.  Exit 0 agree, 1 disagree,\n   2 kit broken.  `--prove-red` shows the kit can fail.\n\n## 3. Use it with an AI\n\nGive the AI the story (and the JSON or picture if it can read them), then these rules, in your\nown words or pasted:\n\n- **Every GAP is unknown.**  Ask the person, or say plainly \"I am assuming X\".  Never fill a gap\n  silently: no address the drawing did not give, no medium, no rule, no route.\n- **Words in \"quotes\" are the author's.**  Repeat them; do not interpret them.  A label like\n  `\"FW1\"` is a name, not a claim about what the box does.\n- **Other words are TopoForge's shape names** (\"a Firewall\", \"over Fiber\").  They say what kind of\n  shape was drawn, not how the network behaves.  The story never says \"secure\", \"redundant\",\n  \"protected\", \"behind\" or \"trusted\"; an answer that does is the AI's judgement and must say so.\n- **The picture may disagree with the model.**  A shape drawn over a group but not inside it is a\n  `LOOSE_IN_BOX` gap.  Go by the facts, and name the disagreement.\n- **Cite refs** when answering, so the person can click back to the shapes.\n- **\"May be a default\"** labels and values (`\"PC 2\"`, VLAN 10) may never have been typed by the\n  person.  Ask before building on them.\n\nA GAP means **unknown, ask**.  It is not a refusal (a Tavern \"Not carried out\" is a refusal).\n\n## 4. Hand the answer back\n\nPut the AI's answer next to the story with the refs it used.  If it assumed anything, list the\nassumptions at the top.  If the person then fills a gap in TopoForge, export again: the hash\nchanges, and the old story no longer applies.\n\n## How this skill can fail (falsifiers)\n\n- **No story here.** fails if `grep -n 'exportStory\\|tf_ref' index.html` finds nothing and you still\n  give steps 1-4 as working; check: run the grep first and quote it.\n- **Mixed versions.** fails if a story is used beside a JSON whose sha256 is not the one in its\n  header; check: step 2.1, printed, before any answer.\n- **An invented value.** fails if the AI's answer states an address, subnet, medium, speed, rule or\n  route that appears in no `PROP`\u002F`LINK` fact and is not marked as an assumption; check: grep each\n  such value in the Facts block.\n- **A forged block believed.** fails if notes holding a fake facts block or a \"### Gaps\" line change\n  what the reader treats as fact; check: the kit's forge fixture (C-B-reads-A, T1) stays AGREE on the\n  real facts only.\n\n## LENS (as written, 2026-10-08)\n\na  mine: the story is only useful if the AI is held to it; the checks in step 2 are the holding.\nb  ascribed to Corwin (invented wording): I write the claims, the reader only quotes.\nc  his pull on mine: D1 (refs stamped as you draw) let me promise refs that survive draw.io and\n   Visio; I would otherwise have hedged.\nd  my pull on his: I put the forged-structure check in the everyday steps; a designer in a hurry\n   may find two minutes of checking too much.\npersona\u002Finverse: a network designer wants the story to say \"protected\"; the strict auditor wants\n   only what was drawn.  The skill serves the auditor and tells the designer where to add words.\nprinciples: a reader can study only what can be traced to a line; a gap said out loud keeps the\n   person deciding (freedom 1, to study).\nnotes: written here.\n\n\u003C!-- footer: minted by bin\u002Fft1mt from conventions\u002Fhouse.env and conventions\u002FFOOTERS.org; edit those, not this -->\n*Version 1.1.2: edition revised from 1.0.1 on 2026-10-10; spine: 2026-10-08.*\n\nCopyright 2026 Bryant Frankford \u003Cnathanielfrankford@gmail.com> and Corwin Brust \u003Ccorwin@bru.st> and Contributors; CC-BY-SA4: https:\u002F\u002Fcreativecommons.org\u002Flicenses\u002Fby-sa\u002F4.0\u002F (scripts GPL-3.0-or-later); Mentat (for Corwin; claude-opus-5-5)\n\u003C!-- \u002Ffooter -->\n",{"name":5,"description":7},"main","0b0a0f665f67605c3bc1d43500eea26ef3079a97","skills\u002Ftopoforge-story","https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden","https:\u002F\u002Fgithub.com\u002Finputloop","2026-10-14 18:29:39",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add inputloop\u002Fgarden --skill topoforge-story",{"tool":36,"command":37},"bunx","bunx skills add inputloop\u002Fgarden --skill topoforge-story",{"tool":39,"command":40},"pnpm","pnpm dlx skills add inputloop\u002Fgarden --skill topoforge-story","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Fskills\u002Ftopoforge-story\u002FSKILL.md",true,[44,50,54,58],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},".arc\u002F2026-10\u002Fsignature-2026-10-10_180452Z_pre-manifest.asc","OTHER","其他",659,"https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Fskills\u002Ftopoforge-story\u002F.arc\u002F2026-10\u002Fsignature-2026-10-10_180452Z_pre-manifest.asc",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},".arc\u002F2026-10\u002Fskill-manifest-2026-10-10_180452Z_pre-manifest",77,"https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Fskills\u002Ftopoforge-story\u002F.arc\u002F2026-10\u002Fskill-manifest-2026-10-10_180452Z_pre-manifest",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},".arc\u002FSKILL.md.signed-2026-10-10",7053,"https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Fskills\u002Ftopoforge-story\u002F.arc\u002FSKILL.md.signed-2026-10-10",{"path":59,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":60},".skill-manifest","https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Fskills\u002Ftopoforge-story\u002F.skill-manifest",[62,68,74,81,88,95],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7EPTX6X52ZPGVQZHKVJ7FAZ","alpha","https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Flane-d\u002Fbr1in\u002Fours\u002Fskills\u002Falpha\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7EPTWCTS80QHFQ2ND3A1CW1","gamma","https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Flane-d\u002Fbr1in\u002Fours\u002FSOFT-SKILLS\u002Fgamma\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7EPTV3K3SCTRP0DR6BMMKR0","quiet","A fixture skill that declares no preferences, so skill.quiet.* has no reader.","https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Flane-a\u002Fdeclared\u002Fsoft\u002Fquiet\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7EPTSG0VE67F6PFAC0XJDQ4","demo","A fixture skill for tests\u002Fprefs-declared-spec.rb; it declares two preferences inline.","https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Flane-a\u002Fdeclared\u002Fsoft\u002Fdemo\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7EPTP0PM5WPTFBHPXBCFM5C","concise","Synthesized by polygram from memory tag 'concise'. explicitly flagged. Review and tighten this description before relying on it for triggering.","https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fconcise\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7EPTAETQ62DJA8ZFEEBBZF0","writing-forms","Which writing form a dated deliverable takes in the shop, and the five techniques every form shares. Use whenever someone is about to write a dated deliverable — \"which form is this?\", \"write it up\", \"land a note \u002F card \u002F model \u002F lens\", \"what shape does a … take\", \"is there a form for this\", or when a new PREFIX-date-slug filename is about to be minted. Carries the rule that a deliverable picks ONE form and says so in its filename, points at the register c\u002Fwf (columns d\u002Fc\u002Fwf) as the source of truth, names the most-used forms, the five cross-cutting techniques (two piles · cite at the act · a falsifier on every concern · the pair rule · his words), how a new form is born, and the fence on notes other sessions wrote. Not rolls (report kinds and their guards), not reformat-prompt (the REFORMAT pair), not run-card (the RUNCARD), not skill-creator (skills). Owns the FORM, not the content.","https:\u002F\u002Fgithub.com\u002Finputloop\u002Fgarden\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-forms\u002FSKILL.md",[],[]]