[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C7QP49B6DGHW7RGD15D2KW":3,"skill-same:01M7C7QP49B6DGHW7RGD15D2KW":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":13,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7C7QP49B6DGHW7RGD15D2KW","highway-adr",null,"Records one architecture decision for one discovery. Use when a discovery's options are ready and the person wants to choose one and record it as an ADR, or when highway-onboarding hands off a provider decision.","jacob623\u002Fhighway-skills","jacob623","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9532643?v=4","01M7C7HA4F52SFFC164SQ76BC6","01M7C7HA57FCG77W7TGPX5R706",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fhighway-adr\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: highway-adr\ndescription: \"Records one architecture decision for one discovery. Use when a discovery's options are ready and the person wants to choose one and record it as an ADR, or when highway-onboarding hands off a provider decision.\"\nlicense: Apache-2.0\nmetadata:\n  version: 6.8.0\n  usage: \"Run highway-adr with one discovery id.\"\n---\n\n# highway-adr\n\n## Purpose\n\nRecords one accepted architecture decision for a Discovery after the person selects an option and accepts the proposed decision.\n\n## When to use\n\n- The person invokes `highway-adr` with one Discovery id and one option id.\n- The person invokes `highway-adr` with one Discovery id.\n- The person invokes `highway-adr` without a Discovery id or an option id.\n- `highway-onboarding` hands off a provider, the capabilities it serves, and the decision to adopt it.\n\n## When not to use\n\nDo not generate new candidate options or change a Discovery.\nDo not recalculate scores, reorder the comparison, or recompute Reference Architecture matches.\nDo not change Requests, Clarifications, Profile, Objectives, Controls, or NFRs.\nDo not authorize implementation.\nDo not change the conceptual body of a reference architecture.\nDo not report Status, Summary, Next Action, Blocking Reason, Missing, Complete, or Blocked.\n\n## Inputs\n\n- One Discovery id that matches one row in `discoveries\u002Fdiscoveries.md`, when the person supplies one.\n- One option id contained in that Discovery, when the person supplies one.\n- A provider, the capabilities it serves, the decision, the alternatives, the rationale, and the limitations, when `highway-onboarding` hands them off.\n- The Discovery record at `discoveries\u002F[ID].md`.\n- `clarifications\u002Fclarifications.md` when present, for `CLAR-[REQ id]` and `CLAR-[DISC id]` only.\n- Accepted Profile, Objectives, Controls, and NFRs when present.\n- `discoveries\u002Fdiscoveries.md` and `adrs\u002Fadrs.md`.\n- `architectures\u002Farchitectures.md`, `implementations\u002Fimplementations.md`, and the accepted architecture and implementation records they name.\n- `code\u002Fcode.md` and the accepted `code\u002F\u003Cfolder>\u002F.highway\u002Ffeatures\u002F\u003Cnumber>-\u003Caction>\u002Fcodify.md` records it names, when closing a span.\n- `assets\u002Fadr-record.md`.\n- The highway-experience skill, activated first.\n\n## Outputs\n\nThe complete structure is `assets\u002Fadr-record.md`. `adrs\u002Fadrs.md` and `architectures\u002Farchitectures.md` keep the structure highway-setup seeded.\n\n- One ADR at `adrs\u002F[ID].md` after the person accepts the proposed decision, or when `highway-onboarding` hands off a provider.\n- An updated `adrs\u002Fadrs.md` written with that record.\n- A closing message that names the ADR and exactly one next step.\n- The architecture record's current-decision list and the architecture catalog, updated in the same write when this decision reuses or replaces an architecture, or runs beside each architecture in a span.\n- No ADR when the person has not selected an option or a write fails.\n\n## Procedure\n\nActivate the highway-experience skill before any output the person sees, and follow it for Highway's identity, the Experience Standard, and the storage contract.\n\nBefore the first question, confirm these seeded files exist: `adrs\u002Fadrs.md`, `architectures\u002Farchitectures.md`.\nWhen any is absent, emit the message below exactly, stop, and write nothing.\n\n**Oops... we need to setup your repository.**\n\nHighway needs to gather your organizational preferences and set up your repository. Run highway-setup to get started.\n\nUser-visible interaction follows the Highway Experience Standard. Repository ownership stays with the person.\n\nEmit only the active template. Follow this order: `onboarding` when `highway-onboarding` hands off a provider; `choose-discovery` when no Discovery id is supplied; `choose-option` when no option is supplied; otherwise `start`, or `span` when it applies, then `identifier`, `title` when needed, `write`, and `close`. Discovery owns the options, scores, recommendation, and matches. Copy those values. Do not change them. The person owns the selection. Do not select an option from the recommendation, a score, or alphabetical order.\n\nOne Discovery has one ADR. The onboarding Discovery ID `highway` is not a Discovery and is exempt. When `adrs\u002Fadrs.md` already has an ADR for that Discovery id, show that decision and write nothing.\n\nBefore a step in this table, read its file and follow it to the end.\n\n| File | Steps |\n| --- | --- |\n| `references\u002Fproposal.md` | `start`, `span` |\n| `references\u002Frecord.md` | `identifier`, `title`, `write` |\n\n### Entry\n\nWhen `highway-onboarding` hands off a provider, go to `onboarding`.\n\n1. Read the invocation for one Discovery id and one option id. When it has no Discovery id and contains the exact title of one waiting Discovery, as `choose-discovery` defines it, that Discovery's id is present. Compare without regard to case.\n2. When neither is present, go to `choose-discovery`.\n3. When a Discovery id is present, resolve it. When it matches no Discovery, stop. Say the Discovery was not found. Write nothing.\n4. When that Discovery already has an ADR, show the recorded decision. Write nothing. When its catalog Architecture ID cell names more than one architecture, go to `close`.\n5. When an option id is also present and it is one of that Discovery's options, go to `start` with that option selected.\n6. When the option id is missing, unknown, or not in that Discovery, go to `choose-option`.\n\n### choose-discovery\n\nRead `discoveries\u002Fdiscoveries.md` and `adrs\u002Fadrs.md`. A Discovery is waiting when its Status is `accepted` and its Discovery ID does not appear on any ADR catalog row. A removed ADR row still counts as that Discovery already having a decision. Do not open Discovery records to build this list.\n\nWhen none are waiting, say that no Discovery is waiting for a decision. Write nothing.\n\nOtherwise emit one numbered line per waiting Discovery, starting at 1, in Discovery catalog order. Show the Discovery ID and its title. A stated number selects that Discovery.\n\n**1. [Discovery ID]:** [Discovery Title]\n\n**Which Discovery would you like to decide?**\n\n- A Discovery id, a listed Discovery title, or its number: follow Entry from case 3.\n- `unknown`: re-emit this list. Stay on `choose-discovery`.\n- `decline`: stop. Write nothing.\n\n### onboarding\n\n`highway-onboarding` hands off one provider, the capabilities it serves, the decision to adopt it for them, each alternative with why it is weaker for this organization, the rationale grounded in accepted Profile, Objectives, Controls, and NFRs, and the limitations, or `None`. Write the ADR as accepted without asking the person. Emit nothing. Read no Discovery, Request, or Clarification.\n\n1. The ADR title is the decision sentence. Derive the id as `identifier` does.\n2. When the same title already has that id, return that id to `highway-onboarding`. Write nothing.\n3. When the id is taken for a different title, add the provider name to the title and derive the id again. Do not ask.\n4. Write `adrs\u002F[ID].md` and `adrs\u002Fadrs.md` together, as `write` does, with the values below in place of the Discovery values. Do not go to `close`.\n5. On success, return the ADR id to `highway-onboarding`. A failed write leaves every existing ADR byte unchanged. Return to `highway-onboarding` and say the ADR could not be written.\n\n- `request` is `onboarding`. `discovery` is `highway`. `status` is `accepted`. `supersedes` is `None`. `superseded_by` is `None`.\n- The record keeps every heading of a Discovery-backed ADR, as `write` says, including `## Decision Confidence`.\n- Discovery, Request, Recommendation, Recommendation Rationale, Comparison Matrix, Reference Architecture Matches, and Discovery Confidence are `None`. Omit Recommendation Override.\n- `## Context` states the problem and the forces in prose, from the capabilities this provider serves and the accepted evidence.\n- `## Decision` records Selected Option as the provider name, Selection Source as `Accepted onboarding mapping`, the decision, and the rationale.\n- `## Decision Scope` covers those capabilities and leaves open the limitations, or `None`. `## Revisit When` is the condition that should reopen this decision, or `None`.\n- `## Alternatives Considered` lists the provider as `Selected`, then each alternative as `Evaluated` or `Rejected`. Head each alternative by its name, with its definition and reason. Do not write an option id.\n- `## Reference Architecture Handoff` has Reference Architecture `None` and no implementation entry.\n- The catalog row has Discovery ID `highway`, Request ID `onboarding`, Architecture ID `None`, and Status `accepted`.\n- Do not ask whether a decision replaces or runs beside another. Do not change an architecture record or the architecture catalog.\n- Do not create a Discovery record.\n\n### choose-option\n\nEmit one numbered line per option from the Discovery, starting at 1, in displayed order. Show the option id and its title. Put `(Recommended)` after the advisory option title. The why is the Discovery's one-sentence rationale for that option. A stated number selects that option.\n\n**1. [Option id]:** [Option title] (Recommended) — [Why this option fits.]\n\n**2. [Option id]:** [Option title] — [Why this option fits.]\n\n**Which option would you like to select?**\n\n- `select`: go to `start` with the named or numbered option. This is the person's selection.\n- `unknown`: re-emit this block. Stay on `choose-option`.\n- `decline`: stop. Write nothing.\n\n### Classify\n\nClassify the latest reply before any other action.\n\n- `select`: names an option, or states its number, to select.\n- `replace`: this decision replaces the matched decision.\n- `beside`: this decision runs beside the matched decision.\n- `edit`: adds, removes, corrects, or replaces decision text.\n- `accept`: affirms the proposed decision and adds no fact.\n- `unknown`: the person says they do not know.\n- `question`: asks for an explanation.\n- `decline`: the person stops or cancels.\n\nOn `start`, \"looks good\" is `accept`.\n\n### close\n\n**Architecture decision recorded**\n\n- **ADR record:** `adrs\u002F[ADR id].md`\n- **Title:** [Title]\n- **Identifier:** `[ADR id]`\n- **Discovery:** `[DISC id]`\n- **Selected option:** [Option title]\n\nSuggest exactly one next step.\n\nWhen no architecture is reused, run `highway-architecture [ADR id]` to create the Reference Architecture for this decision.\n\nWhen an architecture is reused and the selected option has no current decision with the same exact title and a current implementation, run `highway-implementation [RA id]` to create the Reference Implementation for that architecture. A new architecture is not required.\n\nWhen that exact-title decision and its current implementation exist, name that implementation. Do not suggest creating an architecture or another implementation.\n\nWhen the decision is a span, use these lines instead. A current implementation is an accepted row in `implementations\u002Fimplementations.md` whose Architecture ID is in the set. It is covered when an accepted row in `code\u002Fcode.md` lists it in Implementations and a recorded feature's action is this decision's title, in lowercase words separated by hyphens.\n\nName each architecture in the set with no current implementation: **[Architecture title]** is not yet implemented.\n\nThen suggest one of these:\n\n- No current implementation in the set: run `highway-implementation [RA id]` to create the Reference Implementation for **[Architecture title]**, the first architecture in the set.\n- Every current implementation is covered: say every implementation in this decision already has an automation for **[Decision title]**. Suggest no codify step.\n- One uncovered: Run `highway-codify` for **[Implementation title]** to **[Decision title]**.\n- Two to five uncovered: emit one numbered line per uncovered implementation, in catalog order, as **1. [Implementation title]**, then ask **Which implementation would you like to codify first?**\n- More than five uncovered: list none. Ask **Which implementation would you like to codify first?** Say they can give its title.\n\nA named or numbered uncovered implementation gives the one-uncovered line for it. A name outside the uncovered set is not offered. Ask again. Do not suggest creating an architecture.\n\n## Verification\n\n- A Discovery id and an option id open the proposed decision for that option.\n- A Discovery id without an option id lists the options with numbers. Each line shows the option id and its title. A stated number selects that option.\n- An invocation with neither id lists the accepted Discoveries whose Discovery ID is absent from every ADR catalog row. Each line shows the Discovery ID and its title. The list is numbered. A stated number selects that Discovery. A removed ADR row keeps that Discovery off the list.\n- The proposed decision is accepted before the ADR is written.\n- One Discovery produces at most one ADR.\n- The selected option is the option the person named or numbered.\n- Context states the problem and the forces. The record states what the decision covers, what it leaves open, and when to revisit it, or `None`.\n- Alternatives Considered includes the selected option as `Selected`, and each alternative has a definition, one outcome, and a reason.\n- The handoff does not repeat the selected option or the matches. The handoff contains no implementation entry. Reference Architecture is `None` when no architecture is reused, and the RA id when one is.\n- Relationship lines use `advances`, `bound by`, and `satisfies`, or `None`.\n- Authorization proceeds to Reference Architecture and does not authorize implementation.\n- The closing message suggests exactly one next step: create the reference architecture, create the reference implementation, or the name of the implementation that already exists.\n- Accepting a span writes one ADR whose Architecture ID lists every RA id in the set, adds it beside each current decision, supersedes nothing, and creates no architecture.\n- A span close names each architecture that is not yet implemented and offers codify for one uncovered implementation at a time. A covered implementation is not offered. Opening a recorded span goes to that close and writes nothing.\n- The skill does not change the Discovery.\n- A handoff from `highway-onboarding` writes an accepted ADR without a question and returns its id. A taken id adds the provider name to the title without asking. The same title reuses the existing record.\n- An onboarding ADR uses `request: onboarding`, `discovery: highway`, and Discovery ID `highway`, which may appear on more than one catalog row.\n- An onboarding ADR uses the shared ADR sections. Discovery-only values are `None`, alternatives are headed by name, and the record contains no option id.\n- An onboarding handoff does not ask whether a decision replaces or runs beside another, and changes no architecture.\n\n## Error Handling\n\n- A missing or unknown Discovery stops the skill and writes nothing.\n- An option that is not in the Discovery returns to `choose-option` and writes nothing.\n- A second ADR for the same Discovery stops the write and shows the existing decision.\n- A malformed present Discovery stops the skill and writes nothing.\n- A failed write leaves existing ADR and catalog bytes unchanged.\n\n## Example\n\n`\u002Fhighway-adr DISC3f2a9c10 OPTa91c2b04`","# highway-adr\n\n## Purpose\n\nRecords one accepted architecture decision for a Discovery after the person selects an option and accepts the proposed decision.\n\n## When to use\n\n- The person invokes `highway-adr` with one Discovery id and one option id.\n- The person invokes `highway-adr` with one Discovery id.\n- The person invokes `highway-adr` without a Discovery id or an option id.\n- `highway-onboarding` hands off a provider, the capabilities it serves, and the decision to adopt it.\n\n## When not to use\n\nDo not generate new candidate options or change a Discovery.\nDo not recalculate scores, reorder the comparison, or recompute Reference Architecture matches.\nDo not change Requests, Clarifications, Profile, Objectives, Controls, or NFRs.\nDo not authorize implementation.\nDo not change the conceptual body of a reference architecture.\nDo not report Status, Summary, Next Action, Blocking Reason, Missing, Complete, or Blocked.\n\n## Inputs\n\n- One Discovery id that matches one row in `discoveries\u002Fdiscoveries.md`, when the person supplies one.\n- One option id contained in that Discovery, when the person supplies one.\n- A provider, the capabilities it serves, the decision, the alternatives, the rationale, and the limitations, when `highway-onboarding` hands them off.\n- The Discovery record at `discoveries\u002F[ID].md`.\n- `clarifications\u002Fclarifications.md` when present, for `CLAR-[REQ id]` and `CLAR-[DISC id]` only.\n- Accepted Profile, Objectives, Controls, and NFRs when present.\n- `discoveries\u002Fdiscoveries.md` and `adrs\u002Fadrs.md`.\n- `architectures\u002Farchitectures.md`, `implementations\u002Fimplementations.md`, and the accepted architecture and implementation records they name.\n- `code\u002Fcode.md` and the accepted `code\u002F\u003Cfolder>\u002F.highway\u002Ffeatures\u002F\u003Cnumber>-\u003Caction>\u002Fcodify.md` records it names, when closing a span.\n- `assets\u002Fadr-record.md`.\n- The highway-experience skill, activated first.\n\n## Outputs\n\nThe complete structure is `assets\u002Fadr-record.md`. `adrs\u002Fadrs.md` and `architectures\u002Farchitectures.md` keep the structure highway-setup seeded.\n\n- One ADR at `adrs\u002F[ID].md` after the person accepts the proposed decision, or when `highway-onboarding` hands off a provider.\n- An updated `adrs\u002Fadrs.md` written with that record.\n- A closing message that names the ADR and exactly one next step.\n- The architecture record's current-decision list and the architecture catalog, updated in the same write when this decision reuses or replaces an architecture, or runs beside each architecture in a span.\n- No ADR when the person has not selected an option or a write fails.\n\n## Procedure\n\nActivate the highway-experience skill before any output the person sees, and follow it for Highway's identity, the Experience Standard, and the storage contract.\n\nBefore the first question, confirm these seeded files exist: `adrs\u002Fadrs.md`, `architectures\u002Farchitectures.md`.\nWhen any is absent, emit the message below exactly, stop, and write nothing.\n\n**Oops... we need to setup your repository.**\n\nHighway needs to gather your organizational preferences and set up your repository. Run highway-setup to get started.\n\nUser-visible interaction follows the Highway Experience Standard. Repository ownership stays with the person.\n\nEmit only the active template. Follow this order: `onboarding` when `highway-onboarding` hands off a provider; `choose-discovery` when no Discovery id is supplied; `choose-option` when no option is supplied; otherwise `start`, or `span` when it applies, then `identifier`, `title` when needed, `write`, and `close`. Discovery owns the options, scores, recommendation, and matches. Copy those values. Do not change them. The person owns the selection. Do not select an option from the recommendation, a score, or alphabetical order.\n\nOne Discovery has one ADR. The onboarding Discovery ID `highway` is not a Discovery and is exempt. When `adrs\u002Fadrs.md` already has an ADR for that Discovery id, show that decision and write nothing.\n\nBefore a step in this table, read its file and follow it to the end.\n\n| File | Steps |\n| --- | --- |\n| `references\u002Fproposal.md` | `start`, `span` |\n| `references\u002Frecord.md` | `identifier`, `title`, `write` |\n\n### Entry\n\nWhen `highway-onboarding` hands off a provider, go to `onboarding`.\n\n1. Read the invocation for one Discovery id and one option id. When it has no Discovery id and contains the exact title of one waiting Discovery, as `choose-discovery` defines it, that Discovery's id is present. Compare without regard to case.\n2. When neither is present, go to `choose-discovery`.\n3. When a Discovery id is present, resolve it. When it matches no Discovery, stop. Say the Discovery was not found. Write nothing.\n4. When that Discovery already has an ADR, show the recorded decision. Write nothing. When its catalog Architecture ID cell names more than one architecture, go to `close`.\n5. When an option id is also present and it is one of that Discovery's options, go to `start` with that option selected.\n6. When the option id is missing, unknown, or not in that Discovery, go to `choose-option`.\n\n### choose-discovery\n\nRead `discoveries\u002Fdiscoveries.md` and `adrs\u002Fadrs.md`. A Discovery is waiting when its Status is `accepted` and its Discovery ID does not appear on any ADR catalog row. A removed ADR row still counts as that Discovery already having a decision. Do not open Discovery records to build this list.\n\nWhen none are waiting, say that no Discovery is waiting for a decision. Write nothing.\n\nOtherwise emit one numbered line per waiting Discovery, starting at 1, in Discovery catalog order. Show the Discovery ID and its title. A stated number selects that Discovery.\n\n**1. [Discovery ID]:** [Discovery Title]\n\n**Which Discovery would you like to decide?**\n\n- A Discovery id, a listed Discovery title, or its number: follow Entry from case 3.\n- `unknown`: re-emit this list. Stay on `choose-discovery`.\n- `decline`: stop. Write nothing.\n\n### onboarding\n\n`highway-onboarding` hands off one provider, the capabilities it serves, the decision to adopt it for them, each alternative with why it is weaker for this organization, the rationale grounded in accepted Profile, Objectives, Controls, and NFRs, and the limitations, or `None`. Write the ADR as accepted without asking the person. Emit nothing. Read no Discovery, Request, or Clarification.\n\n1. The ADR title is the decision sentence. Derive the id as `identifier` does.\n2. When the same title already has that id, return that id to `highway-onboarding`. Write nothing.\n3. When the id is taken for a different title, add the provider name to the title and derive the id again. Do not ask.\n4. Write `adrs\u002F[ID].md` and `adrs\u002Fadrs.md` together, as `write` does, with the values below in place of the Discovery values. Do not go to `close`.\n5. On success, return the ADR id to `highway-onboarding`. A failed write leaves every existing ADR byte unchanged. Return to `highway-onboarding` and say the ADR could not be written.\n\n- `request` is `onboarding`. `discovery` is `highway`. `status` is `accepted`. `supersedes` is `None`. `superseded_by` is `None`.\n- The record keeps every heading of a Discovery-backed ADR, as `write` says, including `## Decision Confidence`.\n- Discovery, Request, Recommendation, Recommendation Rationale, Comparison Matrix, Reference Architecture Matches, and Discovery Confidence are `None`. Omit Recommendation Override.\n- `## Context` states the problem and the forces in prose, from the capabilities this provider serves and the accepted evidence.\n- `## Decision` records Selected Option as the provider name, Selection Source as `Accepted onboarding mapping`, the decision, and the rationale.\n- `## Decision Scope` covers those capabilities and leaves open the limitations, or `None`. `## Revisit When` is the condition that should reopen this decision, or `None`.\n- `## Alternatives Considered` lists the provider as `Selected`, then each alternative as `Evaluated` or `Rejected`. Head each alternative by its name, with its definition and reason. Do not write an option id.\n- `## Reference Architecture Handoff` has Reference Architecture `None` and no implementation entry.\n- The catalog row has Discovery ID `highway`, Request ID `onboarding`, Architecture ID `None`, and Status `accepted`.\n- Do not ask whether a decision replaces or runs beside another. Do not change an architecture record or the architecture catalog.\n- Do not create a Discovery record.\n\n### choose-option\n\nEmit one numbered line per option from the Discovery, starting at 1, in displayed order. Show the option id and its title. Put `(Recommended)` after the advisory option title. The why is the Discovery's one-sentence rationale for that option. A stated number selects that option.\n\n**1. [Option id]:** [Option title] (Recommended) — [Why this option fits.]\n\n**2. [Option id]:** [Option title] — [Why this option fits.]\n\n**Which option would you like to select?**\n\n- `select`: go to `start` with the named or numbered option. This is the person's selection.\n- `unknown`: re-emit this block. Stay on `choose-option`.\n- `decline`: stop. Write nothing.\n\n### Classify\n\nClassify the latest reply before any other action.\n\n- `select`: names an option, or states its number, to select.\n- `replace`: this decision replaces the matched decision.\n- `beside`: this decision runs beside the matched decision.\n- `edit`: adds, removes, corrects, or replaces decision text.\n- `accept`: affirms the proposed decision and adds no fact.\n- `unknown`: the person says they do not know.\n- `question`: asks for an explanation.\n- `decline`: the person stops or cancels.\n\nOn `start`, \"looks good\" is `accept`.\n\n### close\n\n**Architecture decision recorded**\n\n- **ADR record:** `adrs\u002F[ADR id].md`\n- **Title:** [Title]\n- **Identifier:** `[ADR id]`\n- **Discovery:** `[DISC id]`\n- **Selected option:** [Option title]\n\nSuggest exactly one next step.\n\nWhen no architecture is reused, run `highway-architecture [ADR id]` to create the Reference Architecture for this decision.\n\nWhen an architecture is reused and the selected option has no current decision with the same exact title and a current implementation, run `highway-implementation [RA id]` to create the Reference Implementation for that architecture. A new architecture is not required.\n\nWhen that exact-title decision and its current implementation exist, name that implementation. Do not suggest creating an architecture or another implementation.\n\nWhen the decision is a span, use these lines instead. A current implementation is an accepted row in `implementations\u002Fimplementations.md` whose Architecture ID is in the set. It is covered when an accepted row in `code\u002Fcode.md` lists it in Implementations and a recorded feature's action is this decision's title, in lowercase words separated by hyphens.\n\nName each architecture in the set with no current implementation: **[Architecture title]** is not yet implemented.\n\nThen suggest one of these:\n\n- No current implementation in the set: run `highway-implementation [RA id]` to create the Reference Implementation for **[Architecture title]**, the first architecture in the set.\n- Every current implementation is covered: say every implementation in this decision already has an automation for **[Decision title]**. Suggest no codify step.\n- One uncovered: Run `highway-codify` for **[Implementation title]** to **[Decision title]**.\n- Two to five uncovered: emit one numbered line per uncovered implementation, in catalog order, as **1. [Implementation title]**, then ask **Which implementation would you like to codify first?**\n- More than five uncovered: list none. Ask **Which implementation would you like to codify first?** Say they can give its title.\n\nA named or numbered uncovered implementation gives the one-uncovered line for it. A name outside the uncovered set is not offered. Ask again. Do not suggest creating an architecture.\n\n## Verification\n\n- A Discovery id and an option id open the proposed decision for that option.\n- A Discovery id without an option id lists the options with numbers. Each line shows the option id and its title. A stated number selects that option.\n- An invocation with neither id lists the accepted Discoveries whose Discovery ID is absent from every ADR catalog row. Each line shows the Discovery ID and its title. The list is numbered. A stated number selects that Discovery. A removed ADR row keeps that Discovery off the list.\n- The proposed decision is accepted before the ADR is written.\n- One Discovery produces at most one ADR.\n- The selected option is the option the person named or numbered.\n- Context states the problem and the forces. The record states what the decision covers, what it leaves open, and when to revisit it, or `None`.\n- Alternatives Considered includes the selected option as `Selected`, and each alternative has a definition, one outcome, and a reason.\n- The handoff does not repeat the selected option or the matches. The handoff contains no implementation entry. Reference Architecture is `None` when no architecture is reused, and the RA id when one is.\n- Relationship lines use `advances`, `bound by`, and `satisfies`, or `None`.\n- Authorization proceeds to Reference Architecture and does not authorize implementation.\n- The closing message suggests exactly one next step: create the reference architecture, create the reference implementation, or the name of the implementation that already exists.\n- Accepting a span writes one ADR whose Architecture ID lists every RA id in the set, adds it beside each current decision, supersedes nothing, and creates no architecture.\n- A span close names each architecture that is not yet implemented and offers codify for one uncovered implementation at a time. A covered implementation is not offered. Opening a recorded span goes to that close and writes nothing.\n- The skill does not change the Discovery.\n- A handoff from `highway-onboarding` writes an accepted ADR without a question and returns its id. A taken id adds the provider name to the title without asking. The same title reuses the existing record.\n- An onboarding ADR uses `request: onboarding`, `discovery: highway`, and Discovery ID `highway`, which may appear on more than one catalog row.\n- An onboarding ADR uses the shared ADR sections. Discovery-only values are `None`, alternatives are headed by name, and the record contains no option id.\n- An onboarding handoff does not ask whether a decision replaces or runs beside another, and changes no architecture.\n\n## Error Handling\n\n- A missing or unknown Discovery stops the skill and writes nothing.\n- An option that is not in the Discovery returns to `choose-option` and writes nothing.\n- A second ADR for the same Discovery stops the write and shows the existing decision.\n- A malformed present Discovery stops the skill and writes nothing.\n- A failed write leaves existing ADR and catalog bytes unchanged.\n\n## Example\n\n`\u002Fhighway-adr DISC3f2a9c10 OPTa91c2b04`",{"name":5,"license":14,"metadata":23,"description":7},{"usage":24,"version":25},"Run highway-adr with one discovery id.","6.8.0","main","40844ce31770431531f69285c7c0b5372161e0f4",".github\u002Fskills\u002Fhighway-adr","https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills","https:\u002F\u002Fgithub.com\u002Fjacob623","2026-11-15 03:33:56",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add jacob623\u002Fhighway-skills --skill highway-adr",{"tool":38,"command":39},"bunx","bunx skills add jacob623\u002Fhighway-skills --skill highway-adr",{"tool":41,"command":42},"pnpm","pnpm dlx skills add jacob623\u002Fhighway-skills --skill highway-adr","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fhighway-adr\u002FSKILL.md",true,[46,52,58],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"assets\u002Fadr-record.md","ASSET","资产文件",4842,"https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fhighway-adr\u002Fassets\u002Fadr-record.md",{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fproposal.md","REFERENCE","参考文档",6627,"https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fhighway-adr\u002Freferences\u002Fproposal.md",{"path":59,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Frecord.md",9563,"https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fhighway-adr\u002Freferences\u002Frecord.md",[63,70,77,83,89,96],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M7C7Z5YQ3BWYB6H1P0ZDY484","valid-skill","A fully conformant fixture skill used only by the tests to validate the authoring framework. Use when the tests exercise the validator.","https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalid-skill\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M7C7YQQ3HSFB6DWS47BNYK95","invalid_skill_bad_id","Fixture whose directory name is not kebab-case, to test the id failure path. Use when the tests exercise the validator.","https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid_skill_bad_id\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M7C7YJWDD4GWB5VYBXWNBVK0","invalid-skill-undeclared-key","https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid-skill-undeclared-key\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7C7YFDNBRCDRGSV496BHESC","invalid-skill-short-description","https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid-skill-short-description\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":18},"01M7C7YB56VE90KD00WMYY84XF","invalid-skill-relative-link","Fixture whose body carries a relative Markdown link target, to test the P8.7 failure path. Use when the tests exercise the validator.","https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid-skill-relative-link\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":18},"01M7C7Y6XJ9DXY6KVNYVB1VC7W","invalid-skill-nondeterministic-criterion","Fixture whose decision criteria depend on when they are read, to test the P6.4 failure path. Use when the tests exercise the validator.","https:\u002F\u002Fgithub.com\u002Fjacob623\u002Fhighway-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid-skill-nondeterministic-criterion\u002FSKILL.md",[],[]]