Skip to content

Commit c44174e

Browse files
ComBbaclaude
andauthored
docs(readme): overhaul root README, fix stale counts, plant PDD copy (#109) (#114)
* docs(readme): overhaul root README, fix stale counts, plant PDD copy Resolves #109 — the comparative audit that flagged stale README claims, missing feature documentation, and weak hackathon positioning. Counts corrected (audit A2): - 143 → 144 agents - 14 → 15 slash commands (added /pf:preview) - Hooks 3 → 7 (added idea-drift, cost-regression, escalation-ledger, post-h1-signal) - Schemas 3 → 6 (added pf-profile, idea-spec, spec-anchor-audit) - Removed duplicate "Slash commands" row in inventory table - Replaced "56 checks" claim with plain verify command Documentation added (audit A3, A7, A11): - "The problem" section under hero — the PDD framing - Layer-0 inline summary, corrected from 7 → 10 rules to match methodology/global.md (Rule 9 idea-drift, Rule 10 English-only) - /pf:preview + H1→SpecDD auto-advance + H2 auto-launch in v1.14 notes - Judging criteria evidence map (Impact 30 / Demo 25 / Opus 4.7 25 / Depth 20) - Three "Why this wins" sections aligned to prize categories Main copy "Preview is all you need." planted in 5 strategic spots: - Hero h2 (line 5) - Hero callout closing (line 50) - TL;DR closer (line 86) - Keep Thinking prize closer (line 200) - Footer (line 454) Hero gallery image swapped from v1.6 placeholder to actual LunchPull demo run gallery (9 advocate-rendered mockups, 2576x1372). docs/assets/social-preview.png added — Sangguen will upload to repo Settings → Social preview manually post-merge (audit A1). Side fixes caught by red-team review: - verify-plugin.sh: added post-h1-signal to hooks compile-check loop (was checking only 6 of 7 hooks, contradicting README claim) - methodology/global.md line 143: 143 agent → 144 agent (stale count) - plugin.json description: rewritten in English (was Korean, violating Layer-0 Rule 10) docs/README.md added as the GitHub Pages variant of the same content (Codex preparation), with relative paths adjusted for docs/ context. Verify passes 59/59 locally on macOS. Manual follow-up (cannot be done via PR): - Upload docs/assets/social-preview.png to repo Settings → Social preview - A4 (10-15s GIF) and A8 (3-min Loom link) wait on uploaded video - A12 (vs SuperClaude/wshobson comparison strip) deferred — can revisit Closes #109 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs(readme): land actual demo video URL (#109 A8) Replaces the demo-video placeholder with the uploaded LunchPull end-to-end recording. The video covers the "Asking When It Matters" thesis end-to-end (10:30 runtime, 4 asks, 10 of 14 scenes silent). Closes the audit-A8 deferral. A4 (10–15s GIF) remains optional. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs(readme): correct demo video metadata — 2:59 full walkthrough Previous commit had incorrect duration (10:30 was the storyboard target, not the actual upload) and recording-script-internal subtitle that does not appear in the YouTube upload. Corrected to: 2:59 full walkthrough, problem statement through frozen app. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent b9a7603 commit c44174e

7 files changed

Lines changed: 644 additions & 109 deletions

File tree

README.md

Lines changed: 234 additions & 105 deletions
Large diffs are not rendered by default.

docs/README.md

Lines changed: 406 additions & 0 deletions
Large diffs are not rendered by default.
1.21 MB
Loading

docs/assets/social-preview.png

150 KB
Loading

plugins/preview-forge/.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "pf",
3-
"description": "한 줄 아이디어 → 143명 Opus 4.7 가상 엔지니어링 조직이 PreviewDD → SpecDD → TestDD 3-DD 사이클로 풀스택 앱을 freeze까지. 내장 Design Studio(Claude Design fallback) + Memory Tool + Reflexion 자가학습. Built with Opus 4.7 hackathon.",
3+
"description": "PreviewDD → SpecDD → TestDD: 144 Opus 4.7 personas turn one-line ideas into gallery-first, frozen full-stack apps. Built with Opus 4.7 hackathon.",
44
"version": "1.14.1",
55
"author": {
66
"name": "Two-Weeks-Team",

plugins/preview-forge/methodology/global.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -140,7 +140,7 @@ points and warn — tracked separately.
140140

141141
## 모델 · effort 강제 정책
142142

143-
- **모든 143 agent는 `claude-opus-4-7` 고정**
143+
- **모든 144 agent는 `claude-opus-4-7` 고정**
144144
- Sonnet/Haiku 등 다른 모델 사용 시도 시 훅이 경고 (hard block은 아님)
145145
- Effort 4-tier 정책은 `memory/CLAUDE.md` §3 참조
146146

scripts/verify-plugin.sh

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,10 +83,10 @@ for cmd in bootstrap budget design export freeze gallery help lessons new panel
8383
done
8484
echo
8585

86-
echo "[4/5] Hooks (v1.4+: 6 hooks)"
86+
echo "[4/5] Hooks (v1.14+: 7 hooks)"
8787
python3 -c "import json; d=json.load(open('$PLUGIN_DIR/hooks/hooks.json')); assert 'PreToolUse' in d['hooks'] and 'PostToolUse' in d['hooks']" && \
8888
ok "hooks.json schema" || bad "hooks.json invalid"
89-
for h in factory-policy askuser-enforcement auto-retro-trigger idea-drift-detector cost-regression escalation-ledger; do
89+
for h in factory-policy askuser-enforcement auto-retro-trigger idea-drift-detector cost-regression escalation-ledger post-h1-signal; do
9090
python3 -m py_compile "$PLUGIN_DIR/hooks/$h.py" && ok "hooks/$h.py compiles" || bad "hooks/$h.py syntax"
9191
done
9292
echo

0 commit comments

Comments
 (0)