[PAW About UX] Ground PAW onboarding in project docs#290
Open
[PAW About UX] Ground PAW onboarding in project docs#290
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
lossyrob
commented
Mar 15, 2026
skills/paw-status/SKILL.md
Outdated
|
|
||
| For "What is PAW?", "What does PAW stand for?", or similar onboarding questions: | ||
| - Use the exact name **Phased Agent Workflow**. Never invent an acronym expansion. | ||
| - Ground the answer in repository docs before replying: `README.md` (`## What is PAW?`), `docs/index.md`, `docs/guide/index.md`, and `docs/guide/cli-installation.md`. |
Owner
Author
There was a problem hiding this comment.
Final skill installation target won't have access to the docs, so this will either need to be linked to the documentation website or replaced with in-lined context. @copilot please fix.
Contributor
lossyrob
commented
Mar 15, 2026
| - PAW enables **Context-Driven Development**: agents build understanding through durable artifacts (specs, research, plans) before writing code. | ||
| - PAW supports two workflows: implementation and review. | ||
| - Workflow **stages** are top-level milestones; implementation **phases** are subdivisions inside `ImplementationPlan.md`. | ||
| - If the user also asks how to get started, tailor the answer by platform: |
Owner
Author
There was a problem hiding this comment.
Use the {{vscode}} and {{cli}} templates to modify prompts based on target platform, instead of mentioning target platforms in prompts. @copilot please fix.
Contributor
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
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.
Closes #273
Summary
paw-statusanswer “what is PAW?” and onboarding questions from the README and installation docs instead of inventing an acronym expansionpaw-statusTesting
./scripts/lint-prompting.sh skills/paw-status/SKILL.md./scripts/lint-prompting.sh agents/PAW.agent.mdnpm run lintnpm run compilecd tests/integration && npx tsx --test tests/skills/paw-status-about-paw.test.tscd tests/integration && npx tsc --noEmit -p tsconfig.json.venv/bin/activatewas not present in this worktreeArtifacts
Reviewer Notes
paw-status🐾 Generated with PAW