Skip to content

agent-skill v1.2.3: Canon refresh with ODD compliance#3

Merged
klappy merged 3 commits intomainfrom
agent-skill/v1.2.3-attempt-001
Jan 21, 2026
Merged

agent-skill v1.2.3: Canon refresh with ODD compliance#3
klappy merged 3 commits intomainfrom
agent-skill/v1.2.3-attempt-001

Conversation

@klappy
Copy link
Copy Markdown
Owner

@klappy klappy commented Jan 21, 2026

Summary

  • Compiled PRD guide pack against canon v0.5.4 (README index pattern)
  • INSTRUCTIONS.md generated as ephemeral artifact (ODD compliant)
  • Added 4 new README sources for tree-shakeable memory
  • Deployed to public/agent-skill/v1.2.3/ and updated latest/

Definition of Done

  • Pack recompiled with canon v0.5.4 sources
  • Provenance header shows updated source hashes
  • Pack available at versioned URL
  • /latest/ updated
  • INSTRUCTIONS.md generated per-attempt (ephemeral)
  • Public URL verified with HTTP 200

Deployment Verification

Preview URL: https://20426ceb.klappy-dev-agent-skill.pages.dev/v1.2.3/prd-guide-pack.md

HTTP/2 200 
content-type: text/markdown; charset=utf-8

Attempt

products/agent-skill/v1.2.3/attempts/attempt-001/

Status: CHAMPION (verified with evidence)


Note

Canon refresh + ODD compliance

  • Recompiled PRD guide pack against canon v0.5.4, adding folder README indexes (canon/README.md, odd/README.md, odd/appendices/README.md, odd/decisions/README.md) and updating provenance hashes
  • Enforces ODD: INSTRUCTIONS.md generated per-attempt (moved from persisted src/ to v1.2.3/attempts/attempt-001/INSTRUCTIONS.md)

Distribution + evidence

  • Publishes public/agent-skill/v1.2.3/prd-guide-pack.md and updates public/agent-skill/latest/prd-guide-pack.md; adds v1.2.3/README.md
  • Captures attempt artifacts and verification: ATTEMPT.md, META.json, and evidence (compile-output.txt, hash-comparison.md, deployment-verification.md, compiled pack) confirming HTTP 200 and source hashes

Docs

  • Adds/updates PRD.md (lane root and v1.2.3/) and lane README.md to reflect v1.2.3 scope and structure

Written by Cursor Bugbot for commit e36ddbb. This will update automatically on new commits. Configure here.

Automation added 2 commits January 20, 2026 22:33
- Compiled pack against canon v0.5.4 (README index pattern)
- INSTRUCTIONS.md generated as ephemeral artifact in attempt folder
- Added 4 new README sources for tree-shakeable memory
- Deployed to public/agent-skill/v1.2.3/ and updated latest/

Status: IN_PROGRESS (awaiting deployment verification)
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Jan 21, 2026

Deploying klappy-dev-agent-skill with  Cloudflare Pages  Cloudflare Pages

Latest commit: e36ddbb
Status: ✅  Deploy successful!
Preview URL: https://d96f03ab.klappy-dev-agent-skill.pages.dev
Branch Preview URL: https://agent-skill-v1-2-3-attempt-0.klappy-dev-agent-skill.pages.dev

View logs

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Jan 21, 2026

Deploying klappy-dev-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: e36ddbb
Status: ✅  Deploy successful!
Preview URL: https://a2e421a7.klappy-dev-website.pages.dev
Branch Preview URL: https://agent-skill-v1-2-3-attempt-0.klappy-dev-website.pages.dev

View logs

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Jan 21, 2026

Deploying klappy-dev with  Cloudflare Pages  Cloudflare Pages

Latest commit: e36ddbb
Status: ✅  Deploy successful!
Preview URL: https://0f7666c8.klappy-dev.pages.dev
Branch Preview URL: https://agent-skill-v1-2-3-attempt-0.klappy-dev.pages.dev

View logs

@klappy klappy merged commit 07c7465 into main Jan 21, 2026
4 checks passed
@klappy klappy deleted the agent-skill/v1.2.3-attempt-001 branch January 21, 2026 03:55
klappy pushed a commit that referenced this pull request Jan 22, 2026
- Updates canon version reference from 0.8.0 to 0.10.0
- Adds odd/terminology.md to Pack Sources table (source #3)
- Updates compile-plan.json canon_version
- Fixes DoD provenance header reference

Patch release to incorporate terminology document into pack sources.
klappy added a commit that referenced this pull request Apr 19, 2026
Live validation of telemetry_policy canary (klappy/oddkit#106) against
prod surfaced three gaps the original contract didn't name explicitly
enough:

1. Response envelope shape is part of the contract. A tool that
   returns {action, result} but omits server_time/assistant_text/debug
   breaks the time-discipline system even if governance_source is
   present. Added as Runtime Invariant #3.

2. canon_url parameter must be in the Zod schema, not just documented
   as a concept. MCP silently strips unknown parameters. The canary
   shipped with schema={} and canon_url was unreachable. Added as
   Runtime Invariant #4.

3. Live-smoke against the MCP endpoint is a ship-blocker, not a
   nice-to-have. Internal parser tests passed while the tool shipped
   with broken envelope and silent param stripping. Added as Runtime
   Invariant #7, template referenced.

Refactor Implications section expanded to a 7-point checklist and
acknowledges the canary's partial completion + follow-up PR as the
first documented test of the contract.

Follow-up PR that closes the canary gaps: klappy/oddkit#108.
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