jwalsh / jwalsh/cprr

docs: audit CLAUDE.md instructions across repos for stale cprr commands

Open
#9 0 comments 0 reactions 0 assignees View on GitHub
beads cprr documentation
Dominant language
Go
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Summary

Multiple repos reference cprr commands/flags that don't exist, causing agent failures.

## Findings (2026-03-28 audit)

Across ~30 projects with `.cprr/` directories:

| Ghost Command | Found In | Actual Equivalent |
|---------------|----------|-------------------|
| \`cprr register --id --claim --prediction\` | emacs-mcp-maximalist | \`cprr add --hypothesis\` |
| \`cprr measure --id --result --status\` | emacs-mcp-maximalist | \`cprr evidence\` + \`cprr next\` |
| \`bd create --template conjecture\` | CLAUDE.md (this repo) | \`bd create\` (templates may not exist) |
| \`bd status conjecture-stated\` | CLAUDE.md | \`bd status\` (status names unverified) |

## Action Items

- [ ] Grep all `aygp-dr/*` and `jwalsh/*` CLAUDE.md files for `cprr` references
- [ ] Verify each referenced command/flag actually exists
- [ ] Update or remove stale references
- [ ] Consider adding a `cprr help ` that's easily parseable by agents

Contributor guide

Open the contributing guide

Research direction

Start by grepping the referenced CLAUDE.md files across aygp-dr/* and jwalsh/*, then inspect the .cprr directories and verify each cprr and bd command or flag against the available CLI help. Update or remove stale documentation, and consider the requested parseable cprr help only if the audit shows it is needed. Done means the audited references use existing commands and flags.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
cli, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.