1
0
Fork 0

fix: pedagogical review - add expected output, CLAUDE.md, fix consistency

Address findings from pedagogical review simulating a non-expert user:

- Add CLAUDE.md to project root (was referenced but missing)
- Fix README score from 12/9/1 to 13/8/1 (match feature-map.md)
- Add Expected Output sections to examples 01, 02, 05, 09, 10
- Create pipeline-output/ and briefings/ directories
- Add example ordering guidance in README
- Add plan requirements for examples 11/13 in prerequisites
- Add skill frontmatter explanation in GETTING-STARTED.md
- Explain Cowork/Dispatch with links in cowork-integration
- Expand .gitignore with node_modules and generated output files
- Add model override hints in agent frontmatter comments

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-03-26 20:25:45 +01:00
commit 06ae605051
15 changed files with 237 additions and 35 deletions

View file

@ -38,6 +38,34 @@ Claude Code will:
---
## Expected Output
You should see Claude use 5 tool calls in sequence. The final output
includes a directory tree and file contents:
```
project-scaffold/package.json
project-scaffold/README.md
project-scaffold/.gitignore
```
And the package.json contents:
```json
{
"name": "my-project",
"version": "0.1.0",
"description": "A scaffolded project created by Claude Code"
}
```
**How you know it worked:**
- A `project-scaffold/` directory exists with 3 files inside
- You saw Bash (mkdir), Write (x3), Bash (find), and Read tool calls
- No permission prompts appeared for these safe operations (they are pre-approved in settings.json)
---
## Why This Matters
Shell execution and file I/O are the foundation of every automation. Claude Code