Skip to content

Consolidate docs/design/ and reframe CLAUDE.md as an active build - #114

Merged
coordt merged 1 commit into
mainfrom
docs/consolidate-design-docs
Aug 10, 2026
Merged

Consolidate docs/design/ and reframe CLAUDE.md as an active build#114
coordt merged 1 commit into
mainfrom
docs/consolidate-design-docs

Conversation

@coordt

@coordt coordt commented Aug 10, 2026

Copy link
Copy Markdown
Member

Summary

  • Removed stale/fully-absorbed handoff docs: metadata-schema-summary.md, batching-and-crosslink.md, github-webhooks.md, jira-webhooks.md (content already lived in toolkit-spec.md/CONTEXT.md)
  • Split the still-active cross-linker skill spec (unabsorbed content from batching-and-crosslink.md, live design for open issue Cross-linker skill — spec map #94) into its own cross-linker-spec.md
  • Folded GitHub/Jira webhook payload-shape notes into toolkit-spec.md's adapter section
  • Merged v1-spec.md into toolkit-spec.md: as-built content by default, with explicit "Not yet built" headings for unshipped scope (adapters, the superseded adapter-era skill design, batching CLI extensions) — removes the two-file precedence rule ("v1-spec.md wins where they disagree")
  • Restored idea.md's Gaps section (had drifted to "None" in an earlier bulk-refactor commit) to match what implementation-history.md/CLAUDE.md already say is still open, plus a new page-structure-template gap
  • Reframed CLAUDE.md: wiki_toolkit is now described as a tool under active development with a living design record, not a pitch awaiting org approval

Test plan

  • Verified no dangling references to deleted/moved files (grep for pitch, tickets/, v1-spec outside docs/adr/ historical records)
  • Confirmed pre-commit hooks pass (docs-only change, no code affected)
  • N/A — no build/lint/test step for this docs-only change

…t a pitch

Removes stale/absorbed handoff docs (metadata-schema-summary.md,
batching-and-crosslink.md, github-webhooks.md, jira-webhooks.md), merges
v1-spec.md into toolkit-spec.md as-built with explicit "Not yet built"
sections for unshipped scope, and splits the still-active cross-linker skill
spec into its own file. CLAUDE.md now describes wiki_toolkit as a tool under
active development with a living design record, rather than a pitch awaiting
org approval.
@github-actions

Copy link
Copy Markdown
Contributor

Version hint: no-release
Current version: 0.22.0
New version (when merged): 0.22.0

Comment ID: Display version hint-auto-generated

@github-actions

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://callowayproject.github.io/wiki-toolkit/pr-preview/pr-114/

Built to branch gh-pages at 2026-08-10 17:51 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@coordt
coordt merged commit 611b856 into main Aug 10, 2026
5 checks passed
@coordt
coordt deleted the docs/consolidate-design-docs branch August 10, 2026 17:55
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