Repository navigation
docs: finish the to-prd → to-spec rename in shipped text - #734
Merged
Merged
Conversation
Rework grilling from one-question-at-a-time to asking the whole frontier each round, with background sub-agents for fact-finding so research never blocks the round. Fold the batch-grill-me experiment into grilling and delete it. Re-sync the docs page, including how to opt back into one-at-a-time via global CLAUDE.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Reshape the logic branch from a terminal app into a single self-contained HTML file a non-developer can drive: a labelled state panel, free-play buttons, and tabbed guided walkthroughs (scenarios) with the ordered buttons to press underneath each. The portable pure-logic module still lifts into the real code; the HTML shell is the throwaway primary source. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The reference now covers any document an agent consumes — skills, AGENTS.md/CLAUDE.md, docs reached by a pointer. GLOSSARY.md merged into SKILL.md as a dedup (Avoid-lists and the standalone Predictability definition pruned); skill-only mechanics disclosed to SKILL-MECHANICS.md; the skill is now model-invoked. Clean rename, no alias. Spec: mattpocock/personal-wiki#187 · ships via mattpocock/personal-wiki#193 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
feat!: rename writing-great-skills → writing-for-agents and restructure
Move `to-questionnaire` out of in-progress into `productivity/` and wire it up as a promoted skill: plugin.json entry, top-level + Productivity READMEs under User-invoked, a docs page at docs/productivity/to-questionnaire.md, and a Standalone route in ask-matt framing it as the inverse of /grill-me. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Graduate to-questionnaire into the Productivity bucket
…truth Single source of truth now reaches past the document into the environment. package.json scripts, config files, directory layout and --help output are authoritative already, so a doc restating them is a cache of a lookup that earns its load only when the lookup is expensive. Co-authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
feat(writing-for-agents): add the *cache* leading word for environment truth
…nto release/v1.2
Add the fixed per-question shape (numbered title, body, recommendation line) to grilling's SKILL.md, sync the docs page, and add a changeset. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The recommendation now stands alone on its arrow line. Sync the docs page and changeset to match. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Prefix the numbered question line with ❓ so questions and their ➡️ recommendations are both scannable. Sync the docs page and changeset. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The title now carries its own bold alongside the bold Q-number, so the question line reads as a heading. Sync the docs page and changeset. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The round-by-round rework left the wrappers and callers still promising a one-question-at-a-time interview. Sync grill-me, grill-with-docs and triage (docs + skill step), plus grilling's Codex short_description and the loop-me draft. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Drop the "you may know this document as a PRD" hedge from to-spec and the local tracker template, switch code-review to issue/spec, bring the GitHub and GitLab tracker templates in line with the local one, and fix research.md's dead skills-to-prd link. CHANGELOG and existing changesets keep the old term where they document the rename itself. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
🦋 Changeset detectedLatest commit: a2f9333 The changes in this PR will be included in the next version bump. This PR includes changesets to release 1 package
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
mattpocock
marked this pull request as ready for review
August 4, 2026 06:18
This was referenced Aug 5, 2026
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Audit of
release/v1.2for lingeringPRDreferences, and the cleanup.What was stale
to-specstill opened with "you may know this document as a PRD" (skill + docs page), as did the local-markdown tracker template. Dropped — "spec" is the single through-line term now.code-reviewsaid "issue/PRD" in its frontmatter description, "issue / PRD / spec" in the two-axis summary, and "A PRD/spec file underdocs/…" in the spec-source search order. All now say spec. Both READMEs re-synced.docs/engineering/research.mdlinkedhttps://aihero.dev/skills-to-prd, a dead slug for the renamed skill. Now linksto-spec, matching the nineteen other docs pages.claude-handoff(in-progress) listed "PRDs, plans, ADRs" as artifact types.What was deliberately left
CHANGELOG.mdand.changeset/friendlier-setup-and-local-tickets.mdstill name PRDs — they document the rename, so the old term belongs there.Text-only; there is no build or test in this repo, so verification was re-running the same word-boundary sweep that found the originals. Nothing outside those history files matches now.
🤖 Generated with Claude Code