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

@ -62,6 +62,45 @@ typically completes in 2-4 minutes depending on web fetch latency.
---
## Expected Output
The pipeline takes 2-4 minutes. You will see agent invocations streaming:
1. **Researcher agent** runs WebSearch and WebFetch (30-60 seconds)
2. **Writer agent** produces a ~400-word draft (15-30 seconds)
3. **Reviewer agent** critiques the draft (15-30 seconds)
4. **Revision** if needed (15-30 seconds)
5. **File writes** to pipeline-output/ and memory/
When complete, two new files exist:
`pipeline-output/permission-modes.md` (the article):
```markdown
# How Claude Code Handles Permission Modes
Claude Code provides three permission modes that control how much
autonomy the agent has...
[~400 words with accurate technical content]
```
`memory/pipeline-log.md` (the execution log):
```markdown
## Pipeline Run - March 26, 2026
- **Topic:** How Claude Code handles permission modes
- **Word count:** 412
- **Issues:** None
- **Duration:** ~3 minutes
```
**How you know it worked:**
- Both files exist in the expected directories
- The article is accurate (check against `security/permission-modes-explained.md`)
- The pipeline log has today's date and a word count
- You saw three distinct agent invocations in the terminal
---
## Why This Matters
This is what Claude Code looks like as an actual agent platform, not a