From d6d983f7eb779962704a898d2af895069d307540 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 15 May 2026 06:42:08 +0000 Subject: [PATCH 1/3] chore(backlog): sync issues and pull requests --- ...pr-g-iso-9001-2026-watch-item-t-v06-013.md | 12 +-- ...ning-opportunities-in-scripts-and-sites.md | 8 +- ...se-specorator-scripts-via-bin-in-plugin.md | 8 +- ...d-claude-plugin-validate-to-ci-pipeline.md | 8 +- ...bump-octokit-rest-from-21-1-1-to-22-0-1.md | 4 +- ...-audit-redesign-publishing-pipeline-npm.md | 8 +- ...ature-tracker-ts-defaultissuesdir-after.md | 8 +- ...e-backlog-sync-issues-and-pull-requests.md | 12 +-- ...ages-1-5-ooda-loop-plugin-idea-research.md | 4 +- ...ocs-backlog-the-default-feature-tracker.md | 12 +-- ...-ci-add-claude-plugin-validate-step-453.md | 12 +-- ...n-expose-specorator-scripts-via-bin-449.md | 12 +-- ...oks-json-settings-json-extend-validator.md | 4 +- ...strator-first-plugin-spec-idea-research.md | 4 +- ...ml-trigger-main-paths-add-workflow-call.md | 12 +-- ...ate-plugin-schema-json-from-manifest-md.md | 4 +- ...tages-8-10-test-review-release-prep-for.md | 72 +++++++++++++++ ...evidence-first-public-copy-for-v0-8-1-t.md | 69 ++++++++++++++ ...-repo-ts-into-paths-ts-fs-md-ts-focused.md | 63 +++++++++++++ ...emarkdown-seam-consolidate-link-heading.md | 57 ++++++++++++ ...uce-typed-artifact-reader-backed-by-zod.md | 83 +++++++++++++++++ ...gistry-and-migrate-frontmatter-markdown.md | 58 ++++++++++++ ...nalyzeartifact-shared-core-from-quality.md | 57 ++++++++++++ ...ared-parsefrontmatter-for-astro-content.md | 61 +++++++++++++ ...e-backlog-sync-issues-and-pull-requests.md | 49 ++++++++++ ...eate-goal-skill-for-well-formed-session.md | 89 +++++++++++++++++++ 26 files changed, 724 insertions(+), 66 deletions(-) create mode 100644 docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md create mode 100644 docs/backlog/512-feat-positioning-evidence-first-public-copy-for-v0-8-1-t.md create mode 100644 docs/backlog/513-refactor-split-repo-ts-into-paths-ts-fs-md-ts-focused.md create mode 100644 docs/backlog/514-refactor-add-parsemarkdown-seam-consolidate-link-heading.md create mode 100644 docs/backlog/515-refactor-introduce-typed-artifact-reader-backed-by-zod.md create mode 100644 docs/backlog/516-feat-add-check-registry-and-migrate-frontmatter-markdown.md create mode 100644 docs/backlog/517-refactor-extract-analyzeartifact-shared-core-from-quality.md create mode 100644 docs/backlog/518-refactor-extract-shared-parsefrontmatter-for-astro-content.md create mode 100644 docs/backlog/519-chore-backlog-sync-issues-and-pull-requests.md create mode 100644 docs/backlog/520-feat-skills-add-create-goal-skill-for-well-formed-session.md diff --git a/docs/backlog/181-chore-v06-pr-g-iso-9001-2026-watch-item-t-v06-013.md b/docs/backlog/181-chore-v06-pr-g-iso-9001-2026-watch-item-t-v06-013.md index 8db828646..12eabea76 100644 --- a/docs/backlog/181-chore-v06-pr-g-iso-9001-2026-watch-item-t-v06-013.md +++ b/docs/backlog/181-chore-v06-pr-g-iso-9001-2026-watch-item-t-v06-013.md @@ -7,7 +7,7 @@ title: "chore: ISO 9001:2026 watch item" aliases: - "chore: ISO 9001:2026 watch item" - "chore(v06): PR-G ISO 9001:2026 watch item (T-V06-013)" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/181 author: Luis85 @@ -16,8 +16,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-02T09:41:04Z -updated_at: 2026-05-14T03:20:44Z -closed_at: null +updated_at: 2026-05-14T09:33:54Z +closed_at: 2026-05-14T09:26:44Z comments_count: 0 events_count: 2 locked: false @@ -25,9 +25,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: 7fc083a7865fe9f02ef2649b96d324b32063fea9 +merged: true +merged_at: 2026-05-14T09:26:44Z +merge_commit_sha: dbf41c21296833dc1623649b1985df37f47fa0a9 base_ref: develop head_ref: chore/v06-iso-9001-watch review_count: 0 diff --git a/docs/backlog/377-arch-deepening-opportunities-in-scripts-and-sites.md b/docs/backlog/377-arch-deepening-opportunities-in-scripts-and-sites.md index d11ae65b2..d0c8f369e 100644 --- a/docs/backlog/377-arch-deepening-opportunities-in-scripts-and-sites.md +++ b/docs/backlog/377-arch-deepening-opportunities-in-scripts-and-sites.md @@ -6,8 +6,8 @@ type_locked: false title: "arch: deepening opportunities in scripts/ and sites/ — frontmatter, check-runner, markdown reader" aliases: - "arch: deepening opportunities in scripts/ and sites/ — frontmatter, check-runner, markdown reader" -state: open -state_reason: null +state: closed +state_reason: completed url: https://github.com/Luis85/agentic-workflow/issues/377 author: Luis85 labels: @@ -21,8 +21,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-08T14:40:08Z -updated_at: 2026-05-09T16:51:10Z -closed_at: null +updated_at: 2026-05-14T15:31:56Z +closed_at: 2026-05-14T15:31:56Z comments_count: 1 events_count: 0 locked: false diff --git a/docs/backlog/449-improvement-expose-specorator-scripts-via-bin-in-plugin.md b/docs/backlog/449-improvement-expose-specorator-scripts-via-bin-in-plugin.md index 54e72d352..2addc5875 100644 --- a/docs/backlog/449-improvement-expose-specorator-scripts-via-bin-in-plugin.md +++ b/docs/backlog/449-improvement-expose-specorator-scripts-via-bin-in-plugin.md @@ -6,8 +6,8 @@ type_locked: false title: "improvement: expose Specorator scripts via bin/ in plugin package" aliases: - "improvement: expose Specorator scripts via bin/ in plugin package" -state: open -state_reason: null +state: closed +state_reason: completed url: https://github.com/Luis85/agentic-workflow/issues/449 author: Luis85 labels: @@ -19,8 +19,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-09T22:59:57Z -updated_at: 2026-05-09T23:02:58Z -closed_at: null +updated_at: 2026-05-14T17:53:10Z +closed_at: 2026-05-14T17:53:10Z comments_count: 0 events_count: 0 locked: false diff --git a/docs/backlog/453-improvement-add-claude-plugin-validate-to-ci-pipeline.md b/docs/backlog/453-improvement-add-claude-plugin-validate-to-ci-pipeline.md index 6942d5ee4..827b29610 100644 --- a/docs/backlog/453-improvement-add-claude-plugin-validate-to-ci-pipeline.md +++ b/docs/backlog/453-improvement-add-claude-plugin-validate-to-ci-pipeline.md @@ -6,8 +6,8 @@ type_locked: false title: "improvement: add claude plugin validate to CI pipeline" aliases: - "improvement: add claude plugin validate to CI pipeline" -state: open -state_reason: null +state: closed +state_reason: completed url: https://github.com/Luis85/agentic-workflow/issues/453 author: Luis85 labels: @@ -19,8 +19,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-09T23:00:50Z -updated_at: 2026-05-09T23:03:03Z -closed_at: null +updated_at: 2026-05-14T10:29:11Z +closed_at: 2026-05-14T10:29:11Z comments_count: 0 events_count: 0 locked: false diff --git a/docs/backlog/490-chore-deps-bump-octokit-rest-from-21-1-1-to-22-0-1.md b/docs/backlog/490-chore-deps-bump-octokit-rest-from-21-1-1-to-22-0-1.md index 16d59eade..7f9114ab9 100644 --- a/docs/backlog/490-chore-deps-bump-octokit-rest-from-21-1-1-to-22-0-1.md +++ b/docs/backlog/490-chore-deps-bump-octokit-rest-from-21-1-1-to-22-0-1.md @@ -80,8 +80,8 @@ Bumps [@octokit/rest](https://github.com/octokit/rest.js) from 21.1.1 to 22.0.1.
  • 0e0eaea chore(deps): update dependency @​types/node to v24 (#537)
  • c04acc8 chore(deps): update vitest monorepo to v4 (major) (#536)
  • e6dd306 chore(deps): update dependency undici to v7 ([[474-redesign-claude-code-plugin-install-flow-to-support]])
    • -
  • 5f380d0 build(deps-dev): Bump form-data from 4.0.2 to 4.0.4 in /docs (#520)
    • -
  • dc6827d build(deps-dev): Bump tar-fs from 2.1.2 to 2.1.3 in /docs (#516)
    • +
  • 5f380d0 build(deps-dev): Bump form-data from 4.0.2 to 4.0.4 in /docs ([[520-feat-skills-add-create-goal-skill-for-well-formed-session]])
    • +
  • dc6827d build(deps-dev): Bump tar-fs from 2.1.2 to 2.1.3 in /docs ([[516-feat-add-check-registry-and-migrate-frontmatter-markdown]])
  • 77530ab fix(deps): update octokit monorepo (major) ([[504-fix-site-make-docs-backlog-the-default-feature-tracker]])
  • d07b719 build(deps): Bump vite from 6.2.5 to 6.3.4 ([[509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call]])
  • Additional commits viewable in compare view
    • diff --git a/docs/backlog/491-research-publishing-audit-redesign-publishing-pipeline-npm.md b/docs/backlog/491-research-publishing-audit-redesign-publishing-pipeline-npm.md index 2cacce849..ed8a72d59 100644 --- a/docs/backlog/491-research-publishing-audit-redesign-publishing-pipeline-npm.md +++ b/docs/backlog/491-research-publishing-audit-redesign-publishing-pipeline-npm.md @@ -6,8 +6,8 @@ type_locked: false title: "research(publishing): audit & redesign publishing pipeline — npm · Claude plugin · product page" aliases: - "research(publishing): audit & redesign publishing pipeline — npm · Claude plugin · product page" -state: open -state_reason: null +state: closed +state_reason: completed url: https://github.com/Luis85/agentic-workflow/issues/491 author: Luis85 labels: @@ -19,8 +19,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-11T12:29:47Z -updated_at: 2026-05-11T12:32:40Z -closed_at: null +updated_at: 2026-05-14T10:20:20Z +closed_at: 2026-05-14T10:20:20Z comments_count: 0 events_count: 0 locked: false diff --git a/docs/backlog/496-fix-site-update-feature-tracker-ts-defaultissuesdir-after.md b/docs/backlog/496-fix-site-update-feature-tracker-ts-defaultissuesdir-after.md index 7fb857b0a..07da53f68 100644 --- a/docs/backlog/496-fix-site-update-feature-tracker-ts-defaultissuesdir-after.md +++ b/docs/backlog/496-fix-site-update-feature-tracker-ts-defaultissuesdir-after.md @@ -6,8 +6,8 @@ type_locked: false title: "fix(site): update feature-tracker.ts defaultIssuesDir after issues/ consolidation" aliases: - "fix(site): update feature-tracker.ts defaultIssuesDir after issues/ consolidation" -state: open -state_reason: null +state: closed +state_reason: completed url: https://github.com/Luis85/agentic-workflow/issues/496 author: Luis85 labels: @@ -18,8 +18,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-11T21:34:16Z -updated_at: 2026-05-13T21:07:26Z -closed_at: null +updated_at: 2026-05-14T10:07:07Z +closed_at: 2026-05-14T10:07:07Z comments_count: 0 events_count: 0 locked: false diff --git a/docs/backlog/500-chore-backlog-sync-issues-and-pull-requests.md b/docs/backlog/500-chore-backlog-sync-issues-and-pull-requests.md index fff3a9bb1..8b7b41dca 100644 --- a/docs/backlog/500-chore-backlog-sync-issues-and-pull-requests.md +++ b/docs/backlog/500-chore-backlog-sync-issues-and-pull-requests.md @@ -6,7 +6,7 @@ type_locked: false title: "chore(backlog): sync issues and pull requests" aliases: - "chore(backlog): sync issues and pull requests" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/500 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-12T21:10:56Z -updated_at: 2026-05-14T04:06:16Z -closed_at: null +updated_at: 2026-05-14T11:29:47Z +closed_at: 2026-05-14T11:29:44Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: 0efe385d10e84cbbb997fbf40f705e8f4514de5d +merged: true +merged_at: 2026-05-14T11:29:44Z +merge_commit_sha: 33dee4608c1d486f205b851402dccd3ce99f1389 base_ref: develop head_ref: automation/backlog-sync review_count: null diff --git a/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md b/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md index dfab0e9fd..e16573ba2 100644 --- a/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md +++ b/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:13:07Z -updated_at: 2026-05-14T04:04:26Z +updated_at: 2026-05-14T18:09:44Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 5d4057a6c8b91df20b09d367e6dbedc1bba69583 +merge_commit_sha: cba4eed993ab98cd85e60890386e4250622e4262 base_ref: develop head_ref: claude/create-plugin-concept-issues-TeFk9 review_count: null diff --git a/docs/backlog/504-fix-site-make-docs-backlog-the-default-feature-tracker.md b/docs/backlog/504-fix-site-make-docs-backlog-the-default-feature-tracker.md index abb2875e4..2ff074ef1 100644 --- a/docs/backlog/504-fix-site-make-docs-backlog-the-default-feature-tracker.md +++ b/docs/backlog/504-fix-site-make-docs-backlog-the-default-feature-tracker.md @@ -6,7 +6,7 @@ type_locked: false title: "fix(site): make docs/backlog/ the default feature-tracker source (#496)" aliases: - "fix(site): make docs/backlog/ the default feature-tracker source (#496)" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/504 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:24:34Z -updated_at: 2026-05-14T03:23:55Z -closed_at: null +updated_at: 2026-05-14T10:07:08Z +closed_at: 2026-05-14T10:07:06Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: 074a826493de43cea5bb48541973e0795aa2cfc9 +merged: true +merged_at: 2026-05-14T10:07:06Z +merge_commit_sha: 6c73898ba19ccdb6a49b4832718b2efb09a62bbf base_ref: develop head_ref: claude/triage-github-issues-x6zn1 review_count: null diff --git a/docs/backlog/505-feat-ci-add-claude-plugin-validate-step-453.md b/docs/backlog/505-feat-ci-add-claude-plugin-validate-step-453.md index 4dbfb6aa2..05f6490a7 100644 --- a/docs/backlog/505-feat-ci-add-claude-plugin-validate-step-453.md +++ b/docs/backlog/505-feat-ci-add-claude-plugin-validate-step-453.md @@ -6,7 +6,7 @@ type_locked: false title: "feat(ci): add claude plugin validate step (#453)" aliases: - "feat(ci): add claude plugin validate step (#453)" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/505 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:31:37Z -updated_at: 2026-05-14T03:21:27Z -closed_at: null +updated_at: 2026-05-14T10:29:12Z +closed_at: 2026-05-14T10:29:10Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: b61fe5220683d90f3dd7246c7dad158d27d3ee1b +merged: true +merged_at: 2026-05-14T10:29:10Z +merge_commit_sha: 2683b6366e04a722f4f7e3c2f51a7e21bec44de2 base_ref: develop head_ref: feat/p1-ci-plugin-validate review_count: null diff --git a/docs/backlog/506-feat-plugin-expose-specorator-scripts-via-bin-449.md b/docs/backlog/506-feat-plugin-expose-specorator-scripts-via-bin-449.md index ce03e9d45..ee2dde45a 100644 --- a/docs/backlog/506-feat-plugin-expose-specorator-scripts-via-bin-449.md +++ b/docs/backlog/506-feat-plugin-expose-specorator-scripts-via-bin-449.md @@ -6,7 +6,7 @@ type_locked: false title: "feat(plugin): expose Specorator scripts via bin/ (#449)" aliases: - "feat(plugin): expose Specorator scripts via bin/ (#449)" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/506 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:34:08Z -updated_at: 2026-05-14T03:23:51Z -closed_at: null +updated_at: 2026-05-14T17:53:10Z +closed_at: 2026-05-14T17:53:08Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: e5563e6e344e5516f2ceed1d5f0287f8b5a72d3a +merged: true +merged_at: 2026-05-14T17:53:08Z +merge_commit_sha: 6b268e504dda34bc10044efab2121052b0c7bdf6 base_ref: develop head_ref: feat/p1-plugin-bin-scripts review_count: null diff --git a/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md b/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md index f389b2aa0..9e9e0f5af 100644 --- a/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md +++ b/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:38:25Z -updated_at: 2026-05-14T03:24:20Z +updated_at: 2026-05-14T18:10:29Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 5f2b1248fe89967a2a9dba313ed2894cc7754d0f +merge_commit_sha: 4ab6e74a3ce7cbbb33eb4ba2fc1b7dca8457e915 base_ref: develop head_ref: feat/p1-plugin-foundations review_count: null diff --git a/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md b/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md index 3ba1b489c..a46d20cd1 100644 --- a/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md +++ b/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:38:42Z -updated_at: 2026-05-14T03:24:52Z +updated_at: 2026-05-14T12:29:46Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: feedb366c635fdc085fb6945acc7e643abba2474 +merge_commit_sha: cbe17187730950672df8afa84745e57b56a10980 base_ref: develop head_ref: claude/issue-501-JM4TJ review_count: null diff --git a/docs/backlog/509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call.md b/docs/backlog/509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call.md index f7945c924..90fa932e4 100644 --- a/docs/backlog/509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call.md +++ b/docs/backlog/509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call.md @@ -6,7 +6,7 @@ type_locked: false title: "fix(ci): fix pages.yml trigger — main+paths, add workflow_call (#491)" aliases: - "fix(ci): fix pages.yml trigger — main+paths, add workflow_call (#491)" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/509 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:40:58Z -updated_at: 2026-05-14T03:27:56Z -closed_at: null +updated_at: 2026-05-14T10:20:21Z +closed_at: 2026-05-14T10:20:18Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: aed5f967e2c6d4c8c9a472eef64ea10de681c504 +merged: true +merged_at: 2026-05-14T10:20:18Z +merge_commit_sha: 34ccffa784efda768a22166d470d5cef2bf2ee15 base_ref: develop head_ref: feat/p1-pages-trigger-fix review_count: null diff --git a/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md b/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md index cda34fe8f..c03c77b55 100644 --- a/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md +++ b/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:42:29Z -updated_at: 2026-05-14T03:22:15Z +updated_at: 2026-05-14T18:07:22Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 95cd4e5ba4fe2e3d2259043965ec0a20d43dc40c +merge_commit_sha: 18f94913b8b2afc98ea4ba79a5ab1fbb66523d7f base_ref: develop head_ref: feat/p1-schema-generation review_count: null diff --git a/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md b/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md new file mode 100644 index 000000000..4ad21fd8d --- /dev/null +++ b/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md @@ -0,0 +1,72 @@ +--- +number: 511 +kind: pull-request +type: pull-request +type_locked: false +title: "docs(v06): close out stages 8-10 — test, review, release prep for v0.8.1" +aliases: + - "docs(v06): close out stages 8-10 — test, review, release prep for v0.8.1" +state: open +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/511 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T11:18:53Z +updated_at: 2026-05-14T18:10:13Z +closed_at: null +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: planned +draft: false +merged: false +merged_at: null +merge_commit_sha: 365e5c23bee0eb81bebea6fb03bb8adc6f69bd05 +base_ref: develop +head_ref: feat/v081-release-readiness +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/planned +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/511 + +## Summary + +- Closes out the `version-0-6-plan` workflow Stages 8–10 for v0.8.1 consolidation patch prep +- **Stage 8 (Testing):** `test-plan.md` + `test-report.md` — 10/12 REQs pass; REQ-V06-010 deferred (PR-H), REQ-V06-011 partial (ISO watch-item S3); `npm run verify` green +- **Stage 9 (Review):** `traceability.md` + `review.md` — Verdict: **Approved with conditions** (3 S3/S4, no S1/S2); all conditions resolved or tracked +- **Stage 10 (Release, prepare):** `release-notes.md` targeting v0.8.1, `CHANGELOG.md` updated; `workflow-state.md` advanced to `learning`; PR-D scope-cut corrected; no tag/publish yet + +## What changes + +- `specs/version-0-6-plan/test-plan.md` — new +- `specs/version-0-6-plan/test-report.md` — new +- `specs/version-0-6-plan/traceability.md` — new +- `specs/version-0-6-plan/review.md` — new +- `specs/version-0-6-plan/release-notes.md` — new (v0.8.1 target) +- `specs/version-0-6-plan/implementation-log.md` — T-V06-013 entry backfilled +- `specs/version-0-6-plan/workflow-state.md` — advanced to `learning`, PR-D corrected, `implementation-log.md` marked complete +- `CHANGELOG.md` — v0.8.1 entry added + +## No irreversible actions + +Tag, npm publish, and GitHub Release are **not** done here. Those require explicit human authorisation. + +## Test plan + +- [x] `npm run verify` — green (119.4s) +- [ ] Human review of release-notes.md targeting v0.8.1 + +🤖 Generated with [Claude Code](https://claude.com/claude-code) diff --git a/docs/backlog/512-feat-positioning-evidence-first-public-copy-for-v0-8-1-t.md b/docs/backlog/512-feat-positioning-evidence-first-public-copy-for-v0-8-1-t.md new file mode 100644 index 000000000..65cfee9a9 --- /dev/null +++ b/docs/backlog/512-feat-positioning-evidence-first-public-copy-for-v0-8-1-t.md @@ -0,0 +1,69 @@ +--- +number: 512 +kind: pull-request +type: pull-request +type_locked: false +title: "feat(positioning): evidence-first public copy for v0.8.1 (T-V06-012)" +aliases: + - "feat(positioning): evidence-first public copy for v0.8.1 (T-V06-012)" +state: open +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/512 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T11:23:51Z +updated_at: 2026-05-14T18:03:11Z +closed_at: null +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: planned +draft: false +merged: false +merged_at: null +merge_commit_sha: 4e58a868f19caa3b55e39bdae2937dc6b7733198 +base_ref: develop +head_ref: feat/v081-product-page +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/planned +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/512 + +## Summary + +Closes T-V06-012 (SPEC-V06-007 — evidence-first public positioning). Updates product page and README with evidence-backed claims for work shipped in the v0.6 plan. + +- **Product page lead** (`sites/src/pages/index.astro`): updated from generic workflow description to cite live verified examples, cross-tool adapters (Copilot/Codex/Cursor), adoption profiles, and OWASP-aligned agentic security review path +- **README "What You Get"**: four new bullet points linking to the shipped artifacts (`examples/`, `docs/adapters.md`, `docs/adoption-profiles/`, `docs/agentic-security-review.md`) +- **README Roadmap**: v0.6 marked Done; v0.8.1 entry added as in-progress consolidation patch + +## What is intentionally absent + +Hook-pack positioning omitted per scope-cut verdict (PR-D/T-V06-008/009 shipped advisory but public claims wait for v0.7 per `workflow-state.md` note from 2026-05-02). + +## Traceability + +- Satisfies: REQ-V06-010 (SPEC-V06-007), NFR-V06-005 +- Closes: FINDING-V06-002 from `specs/version-0-6-plan/review.md` + +## Test plan + +- [x] `npm run verify` — green (114.2s) +- [x] `npm run sites:build` — green (7.36s, 1 page built) +- [x] Product page lead updated and evidence-backed (no unsupported claims) +- [x] Hook-pack claims absent + +🤖 Generated with [Claude Code](https://claude.com/claude-code) diff --git a/docs/backlog/513-refactor-split-repo-ts-into-paths-ts-fs-md-ts-focused.md b/docs/backlog/513-refactor-split-repo-ts-into-paths-ts-fs-md-ts-focused.md new file mode 100644 index 000000000..25129cc37 --- /dev/null +++ b/docs/backlog/513-refactor-split-repo-ts-into-paths-ts-fs-md-ts-focused.md @@ -0,0 +1,63 @@ +--- +number: 513 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: split repo.ts into paths.ts + fs-md.ts focused modules" +aliases: + - "refactor: split repo.ts into paths.ts + fs-md.ts focused modules" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/513 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T12:31:29Z +updated_at: 2026-05-14T12:41:20Z +closed_at: 2026-05-14T12:41:18Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T12:41:18Z +merge_commit_sha: 19dbea1ca07a4da28a2c05fed2334a1c31c8872e +base_ref: develop +head_ref: refactor/issue-377-repo-split +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/513 + +## Summary +- Creates `scripts/lib/paths.ts` with path helpers (`toPosix`, `findRepoRoot`) +- Creates `scripts/lib/fs-md.ts` with fs helpers (`readText`, `writeText`, `replaceGeneratedBlock`) +- Moves `failIfErrors` from `repo.ts` to `diagnostics.ts` where it logically belongs (all its dependencies are already there) +- Reduces `repo.ts` to backward-compat barrel + inline `repoRoot`/`relativeToRoot`/`walkFiles`/`markdownFiles`/frontmatter/YAML helpers +- Regenerates `docs/scripts/` to reflect new module structure +- Imports become self-documenting; no behavior change — all existing callers continue to work via barrel re-exports + +## Triage +- **Type:** refactor +- **Priority:** normal +- Part of [[377-arch-deepening-opportunities-in-scripts-and-sites]] + +## Test plan +- [x] `npx tsc -p tsconfig.scripts.json --noEmit` — clean (no circular deps) +- [x] `check:cli-contract` — passes (`SPECORATOR_ROOT` and `findRepoRoot` remain visible in `repo.ts` source) +- [x] `npm run verify` — green (all 518 tests pass, all checks pass) + +🤖 Implemented via issue-377 plan diff --git a/docs/backlog/514-refactor-add-parsemarkdown-seam-consolidate-link-heading.md b/docs/backlog/514-refactor-add-parsemarkdown-seam-consolidate-link-heading.md new file mode 100644 index 000000000..1b2a12603 --- /dev/null +++ b/docs/backlog/514-refactor-add-parsemarkdown-seam-consolidate-link-heading.md @@ -0,0 +1,57 @@ +--- +number: 514 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: add parseMarkdown seam — consolidate link/heading extraction" +aliases: + - "refactor: add parseMarkdown seam — consolidate link/heading extraction" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/514 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T12:32:31Z +updated_at: 2026-05-14T12:43:58Z +closed_at: 2026-05-14T12:43:56Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T12:43:56Z +merge_commit_sha: e8371b792ed8da9258129bb205023168247dc6e6 +base_ref: develop +head_ref: refactor/issue-377-markdown-seam +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/514 + +## Summary +- Introduces `scripts/lib/markdown-parser.ts` with `parseMarkdown(text) → MarkdownDoc` +- Refactors `markdown-links.ts` `collectAnchors` to use `parseMarkdown` (removes duplicate heading-regex loop) +- Refactors `quality-metrics.ts` `collectEarsCoverage` to use `parseMarkdown(text).body` (strips frontmatter before scanning, preventing YAML key-name false matches) +- Adds `tests/scripts/markdown-parser.test.ts` with 11 tests — unit coverage + live consumer verification for both production consumers +- Regenerates `docs/scripts/` for the new module + +## Triage +- **Type:** refactor +- **Priority:** normal +- Part of [[377-arch-deepening-opportunities-in-scripts-and-sites]] + +🤖 Implemented via issue-377 plan diff --git a/docs/backlog/515-refactor-introduce-typed-artifact-reader-backed-by-zod.md b/docs/backlog/515-refactor-introduce-typed-artifact-reader-backed-by-zod.md new file mode 100644 index 000000000..44c427110 --- /dev/null +++ b/docs/backlog/515-refactor-introduce-typed-artifact-reader-backed-by-zod.md @@ -0,0 +1,83 @@ +--- +number: 515 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: introduce typed artifact reader backed by Zod schemas" +aliases: + - "refactor: introduce typed artifact reader backed by Zod schemas" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/515 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T13:15:05Z +updated_at: 2026-05-14T16:27:20Z +closed_at: 2026-05-14T16:27:16Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T16:27:16Z +merge_commit_sha: b54f074cccb010df2e130d2a2d8275491b05d6db +base_ref: develop +head_ref: refactor/issue-377-artifact-reader +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/515 + +## Summary + +- Introduces `scripts/lib/artifact-reader.ts` with `readArtifact` and `readArtifactOrNull` — the typed seam mandated by ADR-0042 +- Migrates 12 `extractFrontmatter` / `parseSimpleYaml` call-sites to the new API with co-located Zod schemas +- Marks `extractFrontmatter` and `parseSimpleYaml` as `@internal` in `repo.ts`; `check-claude-plugin.ts` carries a documented exception (`// @internal: parsing raw text snippet — readArtifact does not apply`) +- Adds 8 unit tests in `tests/scripts/artifact-reader.test.ts` covering the happy path, ZodError on invalid data, and null/throw behaviour for missing files +- Installs `zod@^4` as a runtime dependency (ADR-0023 approved Zod as runtime validator) + +## Consumers migrated + +| File | Schema | Notes | +|---|---|---| +| `scripts/lib/adr.ts` | `AdrFrontmatterSchema` | file-based | +| `scripts/check-token-budget.ts` | `SkillFrontmatterSchema` | `description: z.unknown()` (block-scalar) | +| `scripts/check-backlog.ts` | `BacklogRawSchema` (passthrough) | passes raw to full YAML parser | +| `scripts/sync-backlog.ts` | `BacklogRawSchema` (passthrough) | same | +| `scripts/lib/release-package-contract.ts` | `DocStubFrontmatterSchema` | file-based | +| `scripts/lib/release-stubify.ts` | `StubifyFrontmatterSchema` | text-based; `schema.parse()` only | +| `scripts/lib/obsidian.ts` | `ObsidianFrontmatterSchema` (passthrough) | raw content validated separately | +| `scripts/lib/roadmaps.ts` | `RoadmapStateFrontmatterSchema` + evidence schemas | file-based | +| `scripts/lib/traceability.ts` | `TraceabilityStateFrontmatterSchema` + artifact schema | text-based | +| `scripts/lib/spec-state.ts` | `WorkflowStateFrontmatterSchema` | text-based | +| `scripts/lib/agent-artifacts.ts` | `AgentFrontmatterSchema`, `SkillFrontmatterSchema` | file-based | +| `scripts/lib/quality-metrics.ts` | `WorkflowStateFrontmatterSchema` | file-based | +| `scripts/check-frontmatter.ts` | `AnyFrontmatterSchema` (passthrough) | dynamic key checking | + +## Test plan + +- [x] `npm run verify` green (537/537 tests, lint, typecheck, all checks) +- [x] Unit tests: `readArtifact` valid, `readArtifact` ZodError, `readArtifact` missing file, `readArtifactOrNull` null on missing, `readArtifactOrNull` returns data, `readArtifactOrNull` throws on invalid, no frontmatter + required field, no frontmatter + all optional +- [x] Branch pushed from worktree `.worktrees/issue-377-artifact-reader` + +## References + +- Closes part of [[377-arch-deepening-opportunities-in-scripts-and-sites]] +- Implements ADR-0042 (typed artifact reader seam) +- ADR-0023 (Zod as runtime validator) + +🤖 Generated with [Claude Code](https://claude.com/claude-code) diff --git a/docs/backlog/516-feat-add-check-registry-and-migrate-frontmatter-markdown.md b/docs/backlog/516-feat-add-check-registry-and-migrate-frontmatter-markdown.md new file mode 100644 index 000000000..e77267576 --- /dev/null +++ b/docs/backlog/516-feat-add-check-registry-and-migrate-frontmatter-markdown.md @@ -0,0 +1,58 @@ +--- +number: 516 +kind: pull-request +type: pull-request +type_locked: false +title: "feat: add Check registry and migrate frontmatter/markdown-link checks" +aliases: + - "feat: add Check registry and migrate frontmatter/markdown-link checks" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/516 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T14:54:25Z +updated_at: 2026-05-14T16:37:35Z +closed_at: 2026-05-14T16:37:33Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T16:37:33Z +merge_commit_sha: 04259ca36da39edc5c5e8be9fefc722e3d0ec78d +base_ref: develop +head_ref: feat/issue-377-check-runner +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/516 + +## Summary +- Introduces `Check` interface (`id`, `match(file): boolean`, `run(ctx): Promise`) in `scripts/lib/check-contract.ts` +- Adds `registry: Check[]` + `registerCheck()` to `scripts/lib/tasks.ts` — all 5 existing exports preserved +- Rewrites `scripts/lib/changed-checks.ts` to derive run-set from registry (no hardcoded paths) +- Migrates `check-frontmatter.ts` and `check-markdown-links.ts` as first 2 live adapters +- CLI entry-point guard prevents side-effects when imported by registry consumers + +## Triage +- **Type:** enhancement / refactor +- **Priority:** normal (Wave 3 of issue [[377-arch-deepening-opportunities-in-scripts-and-sites]]) + +Partial implementation of [[377-arch-deepening-opportunities-in-scripts-and-sites]] (Wave 3 — check-runner seam) + +🤖 Resolved via `/issue:tackle 377` Wave 3 diff --git a/docs/backlog/517-refactor-extract-analyzeartifact-shared-core-from-quality.md b/docs/backlog/517-refactor-extract-analyzeartifact-shared-core-from-quality.md new file mode 100644 index 000000000..e2e9b8ad6 --- /dev/null +++ b/docs/backlog/517-refactor-extract-analyzeartifact-shared-core-from-quality.md @@ -0,0 +1,57 @@ +--- +number: 517 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: extract analyzeArtifact shared core from quality-metrics and release-readiness" +aliases: + - "refactor: extract analyzeArtifact shared core from quality-metrics and release-readiness" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/517 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T14:54:31Z +updated_at: 2026-05-14T16:59:24Z +closed_at: 2026-05-14T16:59:21Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T16:59:21Z +merge_commit_sha: 73e63f2733654aeb25a68efddfeba584c9cf6c65 +base_ref: develop +head_ref: refactor/issue-377-artifact-analysis +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/517 + +## Summary +- Creates `scripts/lib/artifact-analysis.ts` with `analyzeArtifact(filePath): ArtifactReport | null` shared core +- `quality-metrics.ts` uses `hasFrontmatter()` from shared module (eliminates `safeExtractFrontmatter`) +- `release-readiness.ts` gains `analyzeReleaseNotesArtifact()` as second consumer stub (wiring tracked via TODO) +- `completenessScore` uses 0–100 range (DoD said 0.0–1.0; 0–100 chosen for readability — documented in JSDoc) + +## Triage +- **Type:** refactor +- **Priority:** normal (Wave 3 of issue [[377-arch-deepening-opportunities-in-scripts-and-sites]]) + +Partial implementation of [[377-arch-deepening-opportunities-in-scripts-and-sites]] (Wave 3 — artifact-analysis merge) + +🤖 Resolved via `/issue:tackle 377` Wave 3 diff --git a/docs/backlog/518-refactor-extract-shared-parsefrontmatter-for-astro-content.md b/docs/backlog/518-refactor-extract-shared-parsefrontmatter-for-astro-content.md new file mode 100644 index 000000000..554c3cf02 --- /dev/null +++ b/docs/backlog/518-refactor-extract-shared-parsefrontmatter-for-astro-content.md @@ -0,0 +1,61 @@ +--- +number: 518 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: extract shared parseFrontmatter for Astro content loaders" +aliases: + - "refactor: extract shared parseFrontmatter for Astro content loaders" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/518 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T14:54:37Z +updated_at: 2026-05-14T15:31:57Z +closed_at: 2026-05-14T15:31:55Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T15:31:55Z +merge_commit_sha: e861f6846fcab071c4028fdd6786017e8a6be97d +base_ref: develop +head_ref: refactor/issue-377-sites-loader +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/518 + +## Summary +- Creates `sites/src/content/loaders/parse-frontmatter.ts` — self-contained, no `scripts/lib` imports +- Consolidates inline `parseFrontmatter` from `adr-loader.ts`, `glossary-loader.ts`, `feature-tracker.ts`, `workflow-states-loader.ts` +- Superset signature: `parseFrontmatter(text, { stripInlineComments? }): { frontmatter, body } | null` +- Astro build green; 529 tests passed + +## Known gaps (follow-up) +- `user-manuals-loader.ts` still has its own inline `parseFrontmatter` (tracked as follow-up F-03) +- Unit tests for `parse-frontmatter.ts` in isolation (follow-up F-02) + +## Triage +- **Type:** refactor +- **Priority:** normal (Wave 3 of issue [[377-arch-deepening-opportunities-in-scripts-and-sites]]) + +Partial implementation of [[377-arch-deepening-opportunities-in-scripts-and-sites]] (Wave 3 — sites content-loader dedup) + +🤖 Resolved via `/issue:tackle 377` Wave 3 diff --git a/docs/backlog/519-chore-backlog-sync-issues-and-pull-requests.md b/docs/backlog/519-chore-backlog-sync-issues-and-pull-requests.md new file mode 100644 index 000000000..1057f06b6 --- /dev/null +++ b/docs/backlog/519-chore-backlog-sync-issues-and-pull-requests.md @@ -0,0 +1,49 @@ +--- +number: 519 +kind: pull-request +type: pull-request +type_locked: false +title: "chore(backlog): sync issues and pull requests" +aliases: + - "chore(backlog): sync issues and pull requests" +state: open +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/519 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T17:46:51Z +updated_at: 2026-05-14T18:03:44Z +closed_at: null +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: planned +draft: false +merged: false +merged_at: null +merge_commit_sha: 70b964b12fb32ed07737ddac1fcc48f3a203288d +base_ref: develop +head_ref: chore/backlog-sync-post-377 +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/planned +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/519 + +## Summary +- Pull current GitHub state for 23 backlog entries (15 updated, 8 new mirrors for PRs 511–518) +- New mirrors cover the 6 arch-deepening PRs merged for issue [[377-arch-deepening-opportunities-in-scripts-and-sites]] plus 2 other items + +🤖 Generated with [Claude Code](https://claude.com/claude-code) diff --git a/docs/backlog/520-feat-skills-add-create-goal-skill-for-well-formed-session.md b/docs/backlog/520-feat-skills-add-create-goal-skill-for-well-formed-session.md new file mode 100644 index 000000000..f6ea3c66f --- /dev/null +++ b/docs/backlog/520-feat-skills-add-create-goal-skill-for-well-formed-session.md @@ -0,0 +1,89 @@ +--- +number: 520 +kind: pull-request +type: pull-request +type_locked: false +title: "feat(skills): add /create-goal skill for well-formed session goal design" +aliases: + - "feat(skills): add /create-goal skill for well-formed session goal design" +state: open +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/520 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T23:23:35Z +updated_at: 2026-05-15T03:50:12Z +closed_at: null +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: planned +draft: false +merged: false +merged_at: null +merge_commit_sha: c265081cc3ebe7cbdf09f498c5394326a3aba62d +base_ref: develop +head_ref: claude/add-goal-creation-skill-DhkjZ +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/planned +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/520 + +## Summary + +- Adds a `/create-goal` skill that runs a grill-style interview (one question at a time, recommended answers throughout) to elicit a well-formed session goal +- Produces `docs/goals/.md` with verification method, permitted autonomy, and session log sections +- Emits a verifiable stop-hook condition string ready to paste into `/goal ` +- Registers the skill in the developer-tools plugin group, automation registry, and all command inventories + +## What is this solving? + +Claude Code's `/goal` stop hook is powerful but easy to misuse — vague conditions ("the feature is done") never trigger, and the Haiku evaluator can only check state that Claude has surfaced in the conversation transcript. Users need help designing a well-formed condition before committing to a long session. + +This skill is the equivalent of "grill me" but for goal creation: rather than interrogating an existing artifact, it surfaces the dimensions of a good goal from a vague intent. + +## Deliverables + +| File | Purpose | +|---|---| +| `.claude/skills/create-goal/SKILL.md` | 10-step interview procedure; explains stop-hook mechanics, quality criteria | +| `.claude/commands/create-goal.md` | `/create-goal` slash command entry point | +| `templates/goal-template.md` | Structured goal artifact template with all required sections | +| `docs/goals/README.md` | New sink directory for goal documents | +| `docs/sink.md` | Adds `docs/goals/` to layout and ownership table | +| `.claude/skills/README.md` | Adds skill to cross-cutting sink catalog | +| `plugins/developer-tools/manifest.md` + `schema.json` | Skill and command registered in plugin group | +| `tools/automation-registry.yml` | Skill registered as automation surface | +| Auto-generated inventories | `check:commands` / `fix:commands` updated 3 inventory files | + +## Research backing + +- `/goal` evaluator uses Haiku reading the conversation transcript — conditions must be provable from the transcript (referenced official Claude Code docs + `/goal` mechanics) +- Interview sequence based on 8-dimension framework from requirements elicitation literature (SMART translation for AI, 5-Whys, Addy Osmani's spec-writing guide) +- Template includes `verification_method` (runnable check), `permitted_autonomy`, and `session_log` — all identified as critical missing elements in AI session failure mode research +- Session log convention matches Augment Code's "session-end spec update" pattern for cross-session continuity + +## Test plan + +- [x] `npm run verify` passes (all 554 tests, all checks including automation-registry, check:commands, check:claude-plugin) +- [x] `/create-goal` appears in skill catalog (system-reminder confirmed) +- [x] Plugin package rebuilt (`build:claude-plugin`) +- [ ] Manual smoke test: invoke `/create-goal test-slug`, walk through all 10 questions, confirm `docs/goals/test-slug.md` is created with correct content + +https://claude.ai/code/session_018Ttt39cN8FvxTuZN87zrxQ + +--- +_Generated by [Claude Code](https://claude.ai/code/session_018Ttt39cN8FvxTuZN87zrxQ)_ From 25b6d0aaa0a27fbb4d29e927f5525fee65a88341 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 16 May 2026 06:07:28 +0000 Subject: [PATCH 2/3] chore(backlog): sync issues and pull requests --- ...ages-1-5-ooda-loop-plugin-idea-research.md | 2 +- ...oks-json-settings-json-extend-validator.md | 2 +- ...strator-first-plugin-spec-idea-research.md | 2 +- ...ate-plugin-schema-json-from-manifest-md.md | 2 +- ...tages-8-10-test-review-release-prep-for.md | 2 +- ...e-backlog-sync-issues-and-pull-requests.md | 2 +- ...eate-goal-skill-for-well-formed-session.md | 12 ++-- ...e-backlog-sync-issues-and-pull-requests.md | 54 ++++++++++++++++ ...y-add-security-md-and-pin-devalue-5-8-1.md | 64 +++++++++++++++++++ 9 files changed, 130 insertions(+), 12 deletions(-) create mode 100644 docs/backlog/521-chore-backlog-sync-issues-and-pull-requests.md create mode 100644 docs/backlog/522-fix-security-add-security-md-and-pin-devalue-5-8-1.md diff --git a/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md b/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md index e16573ba2..cfd92482e 100644 --- a/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md +++ b/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: cba4eed993ab98cd85e60890386e4250622e4262 +merge_commit_sha: a29bb7836b79fc1ab0b3cf88c2f9f058b3e067d7 base_ref: develop head_ref: claude/create-plugin-concept-issues-TeFk9 review_count: null diff --git a/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md b/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md index 9e9e0f5af..5f527d260 100644 --- a/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md +++ b/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 4ab6e74a3ce7cbbb33eb4ba2fc1b7dca8457e915 +merge_commit_sha: e992c65660a12b1aebf151c9e2c486b806487b22 base_ref: develop head_ref: feat/p1-plugin-foundations review_count: null diff --git a/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md b/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md index a46d20cd1..3c8eb68f9 100644 --- a/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md +++ b/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: cbe17187730950672df8afa84745e57b56a10980 +merge_commit_sha: 58c793734e46e171b36d9a4e9faf01c5b3c010a1 base_ref: develop head_ref: claude/issue-501-JM4TJ review_count: null diff --git a/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md b/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md index c03c77b55..2161cd1d6 100644 --- a/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md +++ b/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 18f94913b8b2afc98ea4ba79a5ab1fbb66523d7f +merge_commit_sha: null base_ref: develop head_ref: feat/p1-schema-generation review_count: null diff --git a/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md b/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md index 4ad21fd8d..acea0b2a8 100644 --- a/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md +++ b/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 365e5c23bee0eb81bebea6fb03bb8adc6f69bd05 +merge_commit_sha: c43284e6c53253bc622b843f3df305c6ba642d4b base_ref: develop head_ref: feat/v081-release-readiness review_count: null diff --git a/docs/backlog/519-chore-backlog-sync-issues-and-pull-requests.md b/docs/backlog/519-chore-backlog-sync-issues-and-pull-requests.md index 1057f06b6..184ccfbdd 100644 --- a/docs/backlog/519-chore-backlog-sync-issues-and-pull-requests.md +++ b/docs/backlog/519-chore-backlog-sync-issues-and-pull-requests.md @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 70b964b12fb32ed07737ddac1fcc48f3a203288d +merge_commit_sha: 8d4ffe3f4370390a57b38f4b8e0add9a3b5cebab base_ref: develop head_ref: chore/backlog-sync-post-377 review_count: null diff --git a/docs/backlog/520-feat-skills-add-create-goal-skill-for-well-formed-session.md b/docs/backlog/520-feat-skills-add-create-goal-skill-for-well-formed-session.md index f6ea3c66f..28db8c096 100644 --- a/docs/backlog/520-feat-skills-add-create-goal-skill-for-well-formed-session.md +++ b/docs/backlog/520-feat-skills-add-create-goal-skill-for-well-formed-session.md @@ -6,7 +6,7 @@ type_locked: false title: "feat(skills): add /create-goal skill for well-formed session goal design" aliases: - "feat(skills): add /create-goal skill for well-formed session goal design" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/520 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-14T23:23:35Z -updated_at: 2026-05-15T03:50:12Z -closed_at: null +updated_at: 2026-05-15T07:36:58Z +closed_at: 2026-05-15T07:36:55Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: c265081cc3ebe7cbdf09f498c5394326a3aba62d +merged: true +merged_at: 2026-05-15T07:36:55Z +merge_commit_sha: b83261e1b7db4770967a6c6f5751c492e2af3b15 base_ref: develop head_ref: claude/add-goal-creation-skill-DhkjZ review_count: null diff --git a/docs/backlog/521-chore-backlog-sync-issues-and-pull-requests.md b/docs/backlog/521-chore-backlog-sync-issues-and-pull-requests.md new file mode 100644 index 000000000..b7a985a69 --- /dev/null +++ b/docs/backlog/521-chore-backlog-sync-issues-and-pull-requests.md @@ -0,0 +1,54 @@ +--- +number: 521 +kind: pull-request +type: pull-request +type_locked: false +title: "chore(backlog): sync issues and pull requests" +aliases: + - "chore(backlog): sync issues and pull requests" +state: open +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/521 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-15T06:42:10Z +updated_at: 2026-05-15T06:44:03Z +closed_at: null +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: planned +draft: false +merged: false +merged_at: null +merge_commit_sha: a6ea6245e6cb5bfcc02c6f825e3106792d5672c8 +base_ref: develop +head_ref: automation/backlog-sync +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/planned +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/521 + +## Summary +- refreshes the canonical backlog at `docs/backlog/` +- captures GitHub Issues, Pull Requests, comments, events, reviews + +## Verification +- `npm run sync:backlog` +- `npm run check:backlog` + +## Notes +This PR is generated by `.github/workflows/sync-backlog.yml`. diff --git a/docs/backlog/522-fix-security-add-security-md-and-pin-devalue-5-8-1.md b/docs/backlog/522-fix-security-add-security-md-and-pin-devalue-5-8-1.md new file mode 100644 index 000000000..4b03a4c5c --- /dev/null +++ b/docs/backlog/522-fix-security-add-security-md-and-pin-devalue-5-8-1.md @@ -0,0 +1,64 @@ +--- +number: 522 +kind: pull-request +type: pull-request +type_locked: false +title: "fix(security): add SECURITY.md and pin devalue >= 5.8.1" +aliases: + - "fix(security): add SECURITY.md and pin devalue >= 5.8.1" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/522 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-16T03:41:00Z +updated_at: 2026-05-16T03:45:23Z +closed_at: 2026-05-16T03:45:21Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-16T03:45:21Z +merge_commit_sha: ca58eb501702b0159c6aafd7a292f1a49ac38110 +base_ref: develop +head_ref: claude/fix-security-quality-alerts-ag5W6 +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/522 + +## Summary + +Address two findings from the OpenSSF Scorecard report (overall score 5/10) for the public repo: + +- **Security-Policy** (score `0` → `10`): add `SECURITY.md` at repo root with supported versions, GitHub private vulnerability reporting flow, scope, and disclosure expectations. +- **Vulnerabilities** (score `9` → `10`): pin transitive `devalue` (via Astro) from `5.8.0` → `5.8.1` using an npm `overrides` entry in `sites/package.json`. Fixes [GHSA-77vg-94rm-hx3p](https://github.com/advisories/GHSA-77vg-94rm-hx3p) — a high-severity DoS in `devalue.parse` on sparse arrays. The `remote: GitHub found 1 vulnerability` warning printed by `git push` references this same advisory. + +Other Scorecard findings either need admin / process changes (Branch-Protection approver count, Code-Review reviewer count, CII Best Practices badge, Maintained age, Contributors) or are best handled in a follow-up (Token-Permissions audit, Pinned-Dependencies for `markdownlint-cli2` and `actionlint` installer, Signed-Releases provenance — provenance is already on for npm releases per ADR-0044, so the Scorecard miss may resolve on its own as more releases land). + +## Test plan + +- [x] `cd sites && npm ci && npm run build` — Astro static build green with `devalue@5.8.1`. +- [x] `npm run verify` — full verify gate passes locally (57s). +- [ ] CI green on this branch. +- [ ] Next Scorecard run reflects updated `Vulnerabilities` and `Security-Policy` scores. + +https://claude.ai/code/session_01GHbwZTMWQQK4MThj3Hiuds + +--- +_Generated by [Claude Code](https://claude.ai/code/session_01GHbwZTMWQQK4MThj3Hiuds)_ From ed6ed4d406d994c227f9985d10395372d648cee6 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sun, 17 May 2026 06:30:17 +0000 Subject: [PATCH 3/3] chore(backlog): sync issues and pull requests --- ...e-backlog-sync-issues-and-pull-requests.md | 4 +- ...fied-goal-loop-plugin-merging-ooda-goal.md | 95 +++++++++++++++++++ 2 files changed, 97 insertions(+), 2 deletions(-) create mode 100644 docs/backlog/523-feat-plugin-v2-unified-goal-loop-plugin-merging-ooda-goal.md diff --git a/docs/backlog/521-chore-backlog-sync-issues-and-pull-requests.md b/docs/backlog/521-chore-backlog-sync-issues-and-pull-requests.md index b7a985a69..2bb4a0dc7 100644 --- a/docs/backlog/521-chore-backlog-sync-issues-and-pull-requests.md +++ b/docs/backlog/521-chore-backlog-sync-issues-and-pull-requests.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-15T06:42:10Z -updated_at: 2026-05-15T06:44:03Z +updated_at: 2026-05-16T06:07:31Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: a6ea6245e6cb5bfcc02c6f825e3106792d5672c8 +merge_commit_sha: a00d26820fb0993692fd73e0d7b8ed5dcf3cea74 base_ref: develop head_ref: automation/backlog-sync review_count: null diff --git a/docs/backlog/523-feat-plugin-v2-unified-goal-loop-plugin-merging-ooda-goal.md b/docs/backlog/523-feat-plugin-v2-unified-goal-loop-plugin-merging-ooda-goal.md new file mode 100644 index 000000000..0aee2074c --- /dev/null +++ b/docs/backlog/523-feat-plugin-v2-unified-goal-loop-plugin-merging-ooda-goal.md @@ -0,0 +1,95 @@ +--- +number: 523 +kind: pull-request +type: pull-request +type_locked: false +title: "feat(plugin-v2): unified goal-loop plugin merging OODA + goal-orchestrator" +aliases: + - "feat(plugin-v2): unified goal-loop plugin merging OODA + goal-orchestrator" +state: open +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/523 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-16T12:39:06Z +updated_at: 2026-05-17T05:51:57Z +closed_at: null +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: planned +draft: false +merged: false +merged_at: null +merge_commit_sha: ef02550bb1d4dbc0226ecd73ae08e19f1e952ea0 +base_ref: develop +head_ref: claude/unified-plugin-v2-Lmn8x +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/planned +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/523 + +## Summary + +Unifies [[501-idea-goal-oriented-orchestrator-plugin-research-design-plan]] (Goal-Oriented Orchestrator) and [[502-idea-ooda-loop-plugin-observe-orient-decide-act]] (OODA Loop) into one cohesive, domain-agnostic Claude plugin under `plugin-v2/`. Ready to copy into any project and run. + +The merged concept is a **goal-bounded OODA loop**: + +- A **goal** sets *what* and *why* — intent, constraints, falsifiable acceptance criteria, mode (one-shot vs. recurring), cadence, observe sources, act-gate policy. +- The **OODA loop** is *how* — Observe → Orient → Decide → Act, then a Review step that closes or continues the iteration. + +This generalises to issue resolution (one-shot, bounded), daily brief (recurring, awareness), incident triage (rapid tempo), release readiness (checklist gate), and continuous awareness (perpetual). Software examples are illustrative; the method does not assume a software-engineering context. + +The full method, vocabulary, state model, and quality gates are locked in [`plugin-v2/docs/method.md`](../tree/claude/unified-plugin-v2-Lmn8x/plugin-v2/docs/method.md). + +## What ships + +| Surface | Count | Location | +|---|---|---| +| Subagents | 6 (`goal-orchestrator` + 5 phase specialists) | `plugin-v2/agents/` | +| Skills | 7 (`goal-loop` conductor + `set-goal` + 5 phase skills) + 2 shared contracts | `plugin-v2/skills/` | +| Slash commands | 10 under `/goal:*` | `plugin-v2/commands/goal/` | +| Templates | 8 artifact templates + README | `plugin-v2/templates/` | +| Docs | Method, OODA foundations, goal-orientation primer, usage patterns, customizing, tool adapters, 3 worked examples, README | `plugin-v2/docs/` | +| Worked examples | Issue-resolution + daily-brief artifact sets | `plugin-v2/examples/` | +| Codex adapter | `instructions.md` + 2 workflows | `plugin-v2/.codex/` | +| Cursor adapter | Thin pointer rule | `plugin-v2/.cursor/rules/` | +| Plugin manifest | `.claude-plugin/plugin.json` | `plugin-v2/.claude-plugin/` | +| Constitution | 10 articles governing the method | `plugin-v2/memory/constitution.md` | +| Top-level | `README.md`, `CLAUDE.md`, `AGENTS.md`, `LICENSE` | `plugin-v2/` | + +64 new files, 4 460 insertions, no changes outside `plugin-v2/`. + +## How it was built + +A planning step locked the foundation (`docs/method.md` as the canonical method + vocabulary contract, and `.claude-plugin/plugin.json` as the name registry), then five subagents executed in parallel against that contract: agents, skills, commands, templates+constitution, docs+adapters+examples. The conductor then authored the top-level entry points (README / CLAUDE.md / AGENTS.md / LICENSE) and ran an integrity sweep before commit. + +## Test plan + +- [ ] Drop `plugin-v2/` into a fresh project (or symlink for local testing) and confirm Claude Code picks up the `/goal:*` slash commands and the `goal-loop` skill auto-triggers from natural language. +- [ ] Run `/goal:start sample` and confirm `set-goal` interview elicits intent, constraints, falsifiable acceptance, mode, cadence, observe sources, and act-gate policy, then writes `goals/sample/goal-state.md`. +- [ ] Run `/goal:run sample` end-to-end against a low-stakes goal; confirm phase isolation (each phase agent only touches its own artifact) and that the act gate blocks on irreversible actions. +- [ ] Validate the worked examples render cleanly in a Markdown viewer and that all relative links resolve. +- [ ] Verify `.codex/instructions.md` is honoured by a Codex session and `.cursor/rules/goal-loop.mdc` loads in Cursor. +- [ ] Spot-check the constitution against typical edge cases (irreversible action without rollback plan, missing acceptance criterion, contradictory observations). + +Closes [[501-idea-goal-oriented-orchestrator-plugin-research-design-plan]]. +Closes [[502-idea-ooda-loop-plugin-observe-orient-decide-act]]. + +https://claude.ai/code/session_01CxFjqxucdBwScjAkMxU83s + +--- +_Generated by [Claude Code](https://claude.ai/code/session_01CxFjqxucdBwScjAkMxU83s)_