Skip to content

docs(skill): fill the gaps an end-to-end run hit: edge evidence, remotes, node types, evidence check - #68

Merged
hyamero merged 1 commit into
stagingfrom
docs/skill-authoring-gaps
Oct 25, 2026
Merged

hyamero merged 1 commit into
stagingfrom
docs/skill-authoring-gaps

Conversation

@hyamero

@hyamero hyamero commented Oct 24, 2026

Copy link
Copy Markdown
Member

An agent ran the skill end to end on 0.6.1-rc.1, following SKILL.md as written, to diagram this repo's release flow. It validated and delivered, but had to guess in eight places. This fills them in, in skill/SKILL.md and skill/references/authoring-contract.md:

  • Edge evidence: the contract wants edges backed by source, but edges have no evidence field. It now says to cite an edge on the node that makes it, or in the diagram's notes.
  • Remotes: https://github.com/owner/repo.git remotes are covered, not only git@.
  • Unpushed HEAD: the fallback works without an origin/HEAD, and gives the command for "cite only files unchanged since it".
  • Workflow node types: which type a person's step, automation, a third party and a gate take, and where a stop or skip outcome goes.
  • Compact card budget: says the diagnostic's maxChars is exact (the run saw 18 where the contract said about 17).
  • Evidence check: step 7 has a ready-made command. It needs only Node and git, and handles paths with spaces in bash and zsh.
  • Receipt line: now defined.
  • STACKMAP_BIN: says why it's safe to rely on, next to "don't rely on variables set earlier".

The evidence command passes on the test run's diagram, and exits non-zero when a cited file isn't tracked. Package tests (1,146) and site tests (114) pass.

docs, so no release on its own: it ships with the next fix or feature. The workflow example still uses queue for a human-run "Rollback"; it's left as is because the site catalog and the layout corpus use that example.

@vercel

vercel Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
stackmap-site Ready Ready Preview Oct 24, 2026 3:26pm UTC

@hyamero
hyamero merged commit c6742f7 into staging Oct 25, 2026
8 checks passed
@hyamero
hyamero deleted the docs/skill-authoring-gaps branch October 25, 2026 05:41

This branch was successfully deployed

1 active deployment
Preview — a53fb991 Deployed Oct 24, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant