Skills v1 history¶

Historical observations and execution evidence are kept here, separate from the active procedures. Commands and quoted output in the original delivery sections describe the layout at that time, not current validation instructions.

Original index context¶

Read the pinned skill files supplied with the frozen execution contract. These are repository instructions; registration/pinning is a separate Orgchart task. Do not interpret this index as evidence that the live catalog has been updated.

Use the frozen task for scope, named methods and output schema. In particular, Bridge executions use task_result, not interactive claim/status mutations. Universal skills cite source labels on each numbered step and on commands/tables. Read reference definitions at the end of each file to resolve those labels. An instruction label maps to a source section, not a claim of live deployment.

Initial delivery evidence: task 35bef904 v2¶

This index also holds the committed evidence for the six-file documentation task. Repository: h8v6/heyaira; assigned branch: heyaira/35bef904. Source and starting HEAD: 2dc993a8b3ee4bbdee375e480971f874085bdf7d. Execution: 491efeec-3762-4fc3-9e4a-d69578f0e4f8; date: 2026-10-10. The containing commit identifies the candidate; its full SHA is saved in RESULT.

Source reads and limitations¶

Read assigned task through task_get at exact version 2 before changing files.
Matched resource, project and instance through server_identity; runtime reported 3142bcccaf2ac768eb4041ecbed1e04076a9f881.
Read this repository's AGENTS.md, README.md, ARCHITECTURE.md, all four docs/agents/*.md, K0 work contract/roles and task-version execution.
Bridge's separate AGENTS.md read at /Users/jablonskib/HeyAira-agents/heyaira-bridge/AGENTS.md was denied: Operation not permitted.
Execution tools expose no continuity_context or task-status mutation; K0's opening Bridge exception covers this.
The three requested task prefixes are not UUIDs: task_get rejected each with uuid_parsing.
Resolved full IDs for a73430a7 and bdfa9cef from already committed Git evidence, then tried their v2 task reads; both returned execution_task_version_mismatch.
No prefix listing tool is available; no 23ae3ab7 RESULT matched project-memory search. Its receipt was not inspected.
Read RESULT memory 08a80c24-e66a-439e-afbd-f5f0c5063133 for bdfa9cef v2 and its committed evidence at 76dedc473e79ad85344ddb07e245e66fb44b8e5d.
Read RESULT memory 35025870-3d78-4bbe-b044-56c1716902c9 for a73430a7 v2 and its committed evidence at 37f4561115582b51c3e4263794b5c3a2283fedb9.
Read supplemental knowledge RESULT 5cdde945-2835-4d39-adb4-aa60d1ad00f5; used procedure observations, not copied memory contents.
Use K0/AGENTS/execution sources and explicitly cited available RESULTs for rules; do not invent observations from inaccessible receipts or Bridge files.

Reproduction and checks¶

This adds documentation; no runtime defect, behavioral regression test or production change is claimed. On the base, git ls-tree -r --name-only <source> docs/agents/skills returned no files (exit 0). Run the six-file check with the standard-library command below; no dependency install is needed.

python3 -c '
from pathlib import Path
import re
root = Path("docs/agents/skills")
names = ["deliver-bridge-task", "verify-bridge-task", "report-blocker",
         "security-review-checklist", "how-it-works-standard"]
assert {p.name for p in root.iterdir()} == {n + ".md" for n in names} | {"README.md"}
originals = [Path("AGENTS.md").read_text(), Path("docs/specs/org-v1/K0-roles.md").read_text()]
paragraphs = [p.strip() for text in originals for p in text.split("\n\n") if len(p.strip()) >= 100]
for name in names:
    text = (root / (name + ".md")).read_text()
    count = len(text.splitlines())
    assert 60 <= count <= 120, (name, count)
    assert "```" in text and "## Sources" in text, name
    assert not any(p in text for p in paragraphs), name
    if name in names[:3]:
        steps = [s for s in text.splitlines() if re.match(r"^\d+\. ", s)]
        assert steps and all(re.search(r"\[[A-Z]-[a-z]+\]", s) for s in steps), name
    print(f"{name}.md: {count} lines; format, sources, copied-paragraph check PASS")
print("six-file check PASS")
'
git diff --check
git diff 2dc993a8b3ee4bbdee375e480971f874085bdf7d --stat

The paragraph check detects exact source paragraphs; manual reading also checks imperative steps, concrete commands and traceability, rather than treating the scan as a full review.

Actual output and source spot-checks¶

The standard-library check above exited 0 with this output:

deliver-bridge-task.md: 94 lines; format, sources, copied-paragraph check PASS
verify-bridge-task.md: 92 lines; format, sources, copied-paragraph check PASS
report-blocker.md: 95 lines; format, sources, copied-paragraph check PASS
security-review-checklist.md: 88 lines; format, sources, copied-paragraph check PASS
how-it-works-standard.md: 93 lines; format, sources, copied-paragraph check PASS
six-file check PASS

Manual checks paired five concrete rules with their source text:

Skill rule	Source checked at the base	Observation
Deliver step 7: no interactive status mutation	`docs/specs/org-v1/K0-work-contract.md:7`	Opening exception assigns Bridge workers task reads/RESULT only
Deliver step 12: append above carried candidate	`docs/concepts/task-version-execution.md:478`	Resume instructions forbid amend, rebase and reset
Verify step 7: isolated clone without hardlinks	`docs/concepts/task-version-execution.md:172`	Disposable no-hardlinks clone protects the worker candidate
Verify severity table: P1/P2 block, P3 follow-up	`AGENTS.md:80`	Reachable wrong behavior blocks; lower-impact follow-up remains separate
Blocker three-part format	`docs/specs/org-v1/K0-work-contract.md:65`	Contract requires obstruction, next actor and needed action

Read all five files manually: each supplies ordered imperative steps plus shell commands or exact evidence tables/formats; none copies a role/AGENTS paragraph. All numbered universal steps carry source labels; their definitions point to the named contract, AGENTS, execution document or the available bdfa9cef RESULT. The security and knowledge instructions also cite role boundaries and observed receipts.

Initial heredoc checks failed before Python started: can't create temp file for here document: operation not permitted (exit 1). The delivered python3 -c command avoids that operation and passed. Apple's Python shim emitted denied xcrun_db cache diagnostics before the successful run; no packages were installed. The source-label/local-link check exited 0: source-label/local-link check PASS; resolved_labels=43; files=6. It resolved every universal source label and checked all local source/index destinations exist. It then ran the exact README shell snippet and reproduced the six-file output above.

git diff --check and git diff --cached --check exited 0 without output. git diff 2dc993a8b3ee4bbdee375e480971f874085bdf7d --stat showed only the six files listed in the index; git diff --cached --name-only confirmed those same paths. No existing file was modified. Git emitted denied user-ignore-file warnings; staging with -c core.excludesFile=/dev/null succeeded without widening permissions. The final RESULT receipt records commit/parent and clean-worktree read-back. At the initial receipt, independent verification, acceptance, catalog registration and publication were pending.

CI correction evidence: task 35bef904 v2¶

Execution: 508ad00b-9d6f-4817-93a9-ccbcb28f1f93; date: 2026-10-10. Starting candidate: 8a806f522f42e42e05f71686f68f6660c48b68fa, accepted and published by Bridge before the dispatcher reported the failing Documentation run. Read the same frozen task version 2 again; preserve all original criterion IDs.

Reproduction and repair¶

The direct CI log read (gh run view 38059309569 --repo h8v6/heyaira --log-failed) exited 1 because sandbox access to the GitHub CLI configuration was denied. The diagnosis below comes from the local reproduction, not a retrieved CI log.

Using the already installed documentation toolchain, run the CI build method:

python3 -m mkdocs build --strict --site-dir .skill-ci-check/site-docs

On the unchanged starting candidate it exited 1 with:

WARNING - Doc file 'agents/skills/deliver-bridge-task.md' contains a link '../../../AGENTS.md#start-of-every-work-session', but the target '../AGENTS.md' is not found among documentation files.
Aborted with 33 warnings in strict mode!

The same missing-document warning occurred across all five skills. Replace root AGENTS and excluded docs/specs/org-v1/ links with GitHub file URLs pinned to the original source SHA 2dc993a8b3ee4bbdee375e480971f874085bdf7d. Preserve source sections, procedure text and line counts. Keep links to published documentation relative. Do not weaken strict mode or change MkDocs configuration outside task scope.

Actual correction checks¶

python3 scripts/check_docs_contract.py: exit 0; documentation contract passed: 46 MCP tools covered.
python3 scripts/export_mcp_contract.py --check: exit 0; MCP contract is up to date.
Strict MkDocs build after the link repair: exit 0; Documentation built in 2.35 seconds; zero strict-mode warnings.
test -s .skill-ci-check/site-docs/index.html && test -s .skill-ci-check/site-docs/404.html: exit 0.
Six-file length/format/copied-paragraph check: exit 0; skill counts remain 94, 92, 95, 88 and 93; six-file check PASS.
Source/rendered-link check: exit 0; 43 source labels resolved, 30 pinned targets exist in the source commit, all 30 appear in rendered HTML.
Compared each skill against the starting candidate after substituting source URLs: procedure_text_unchanged=5.
No remote GitHub availability claim is made; final scope and commit read-back are recorded in the correction RESULT receipt.

Only the five skills' source links and this README evidence change. Remove the generated .skill-ci-check/ output before committing. Add a new commit above the starting candidate; do not amend, rebase or reset published history. Bridge owns renewed independent verification and publication; this worker does not push.