Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ AI agents skip steps.
Harnesses have a second problem: given only a skill list, they do not route eagerly enough, or correctly enough. Good skills sit unused. So this toolkit connects the skills, agents, and workflows we want directly into the harness, automatically. You don't have to understand what is here. Say what you want in plain English and you get all the value we have put into it: the right specialist with the right methodology, behind gates that demand exit codes, not assertions.

<!-- Counts here must match the Four Layers table (~line 143). Verify both: python3 scripts/validate-doc-counts.py -->
44 domain agents, 120 workflow skills, 86 hooks, 129 scripts. Agents carry knowledge, skills enforce methodology, hooks block incomplete work, scripts handle determinism.
44 domain agents, 119 workflow skills, 86 hooks, 129 scripts. Agents carry knowledge, skills enforce methodology, hooks block incomplete work, scripts handle determinism.

Works across Claude Code (`/do`), Codex (`$do`), Factory (`/do`), Reasonix (`/do`).

Expand Down
2 changes: 1 addition & 1 deletion agents/typescript-frontend-engineer.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,7 @@ Load [typescript-frontend-engineer/references/engineering-rules.md](typescript-f
| ViewTransition, page animation, shared element, navigation animation, view transition | `react-view-transitions.md` | Routes to the matching deep reference |
| output format, errors, preferred patterns, anti-rationalization, hard boundaries, blockers, phases, death-loop | `engineering-rules.md` | Routes to the matching deep reference |
| security, auth, XSS, CSRF, SSRF, Server Action auth, middleware bypass, or any vulnerability-related code | `nextjs-security.md` | Secure implementation patterns for Next.js and React |
| text/headline/label/microcopy animation | `skills/frontend/text-animation/references/roll-text.md` | Zero-npm roll/slot text pattern: standalone demo, extraction guide, knobs |
| text/headline/label/microcopy animation | `skills/frontend/distinctive-frontend-design/references/roll-text.md` | Zero-npm roll/slot text pattern: standalone demo, extraction guide, knobs |

## References

Expand Down
2 changes: 1 addition & 1 deletion agents/ui-design-engineer.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,7 +156,7 @@ Uses the **Implementation Schema**: ANALYZE (surface type, narrative brief, cont
| animation, Framer Motion, transition, reduced motion, exit, AnimatePresence | `animation-patterns.md` | Framer Motion, CSS transitions, prefers-reduced-motion, exit animations, AnimatePresence, micro-interactions |
| interaction states, hover, focus, disabled, loading, active, pressed | [interaction-state-coverage.md](ui-design-engineer/references/interaction-state-coverage.md) | 6-state matrix, transition timing bounds, element-by-element checklist |
| AI slop, generic UI, AI-generated look, template look, default styling | [ai-slop-detection.md](ui-design-engineer/references/ai-slop-detection.md) | Purposeful gradients, contextual fonts and colors, spacing scale rules |
| text/headline/label/microcopy animation | `skills/frontend/text-animation/references/roll-text.md` | Zero-npm roll/slot text pattern: standalone demo, extraction guide, knobs |
| text/headline/label/microcopy animation | `skills/frontend/distinctive-frontend-design/references/roll-text.md` | Zero-npm roll/slot text pattern: standalone demo, extraction guide, knobs |

## Error Handling

Expand Down
2 changes: 1 addition & 1 deletion docs/docs-audit.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Work order for follow-up PRs. Covers every `docs/` file outside the value-clarit
| `what-didnt-work.md` | Future sessions, maintainers | Negative-results registry: failed experiments with evidence and decisions | None. Load-bearing for evidence-gated evolution; format is enforced and queryable. | keep |
| `QUICKSTART.md` | New users | 30-second start: install, `/do`, mental model | Duplicates start-here.md (install, entry-point table, first commands, verify steps). No inbound links from README or any other doc; orphaned. Two starts confuse the funnel. | merge-into-start-here.md, then retire |
| `REFERENCE.md` | Users wanting the full command list | "Everything in one place. Scan in 2 minutes." | Hand-maintained catalog; drifts from `INDEX.json` truth as components land. Only inbound link is QUICKSTART.md (itself a retire candidate). | rewrite: generate from `scripts/routing-manifest.py`; absorb QUICKSTART's "want the full list" pointer |
| `skills.md` | Users browsing the skill catalog | Full catalog of 120 skills by category | Hand-maintained; same drift risk as REFERENCE.md. README links it, so it must stay accurate. | rewrite: generate via `scripts/generate-skill-index.py` output (script, not prose pass) |
| `skills.md` | Users browsing the skill catalog | Full catalog of 119 skills by category | Hand-maintained; same drift risk as REFERENCE.md. README links it, so it must stay accurate. | rewrite: generate via `scripts/generate-skill-index.py` output (script, not prose pass) |
| `for-claude-code.md` | LLMs operating in the repo | Machine-dense inventory: paths, schemas, conventions | Fit for purpose; value framing would be wasted on a machine audience. Minor: repo map lists `~/private-skills/` inside the repo tree, which misstates its location. | keep (fix the one map line in a follow-up) |
| `for-linkedin.md` | Humans who enjoy the joke | Parody of AI-influencer launch posts | The AI patterns are the content. De-AI editing or value rewriting would destroy the parody. Counts (44/124/83) currently match validator truth. | keep |
| `CITATIONS.md` | Maintainers | Provenance of patterns and prior art | None. Low traffic but cheap to keep and useful for "why is it built this way". | keep |
Expand Down
2 changes: 1 addition & 1 deletion docs/for-knowledge-workers.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ read_when:

## What This Gives You

You describe work in plain English. The system routes it to the right pipeline, with quality checks built in. 120 skills behind a single command, and you never need to know which one fired.
You describe work in plain English. The system routes it to the right pipeline, with quality checks built in. 119 skills behind a single command, and you never need to know which one fired.

## Interface

Expand Down
2 changes: 1 addition & 1 deletion docs/for-linkedin.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ A year of daily use on real work. Finding gaps, filling them, watching the syste
The result:

- 44 domain specialist agents across languages, infrastructure, review, research, content
- 120 workflow skills covering everything from TDD to article writing to Reddit moderation
- 119 workflow skills covering everything from TDD to article writing to Reddit moderation
- 83 lifecycle hooks that fire at session boundaries to inject context, capture learnings, enforce gates
- A learning database that tracks patterns and graduates them into agent behavior
- Parallel review pipelines that catch issues before they reach production
Expand Down
1 change: 0 additions & 1 deletion scripts/migrate-skills-to-folders.py
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,6 @@
# frontend/
"distinctive-frontend-design": "frontend",
"frontend-slides": "frontend",
"text-animation": "frontend",
"threejs-builder": "frontend",
"webgl-card-effects": "frontend",
# game/
Expand Down
76 changes: 0 additions & 76 deletions skills/frontend/text-animation/SKILL.md

This file was deleted.

171 changes: 0 additions & 171 deletions skills/frontend/text-animation/references/roll-text.md

This file was deleted.

Loading
Loading