Menú
Persist repo hybrid deltas for .agents/ — tiers, rule-skill pairing, repo exemplars. Use when creating or reviewing rules/skills in this repo. Read writing-great-skills first for skill vocabulary and authoring principles.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Gate Alpine.js UI on Persist hydration (Alpine.plugin + useHydrated / $hydrated). Use when wiring HydrationSignal into Alpine data components.
Gate Angular UI on Persist hydration with useHydrated (readonly Signal). Call inside an injection context; use when avoiding flash of default state on async backends.
Gate Lit element UI on Persist hydration with HydrationController. Use when wiring HydrationSignal into a ReactiveControllerHost; not a hook.
Persist with React Native AsyncStorage via @stainless-code/persist/backends/async-storage. Use for RN string-wire JSON state; always gate with useHydrated.
Compress a string-wire StateStorage with @stainless-code/persist/backends/compressed (gzip/deflate). Backend wrapper — compose with createStorage; stack compress-then-encrypt.
Cross-tab sync for backends without storage events via @stainless-code/persist/transport/crosstab (createBroadcastCrossTab). Wrap storage + pass crossTabEventTarget; call close() on teardown.
| name | writing-agents-config |
| description | Persist repo hybrid deltas for .agents/ — tiers, rule-skill pairing, repo exemplars. Use when creating or reviewing rules/skills in this repo. Read writing-great-skills first for skill vocabulary and authoring principles. |
Read first: writing-great-skills — invocation, information hierarchy, completion criteria, pruning, failure modes.
This repo adds Cursor rules (Tier 1/2/3) on top of a skills-only agent model — always-on STOP rules where cross-turn non-negotiables beat description-only triggers.
Tier framework: agents-tier-system · Layout: agents-first-convention.
alwaysApply: true) — ≤40 lines STOP + pointersglobs:) — thin priming; depth in paired skilldisable-model-invocation: true wrapper → model skill(s)| Check | Pass when |
|---|---|
| Priming size | Rule ~10–40L; procedures in skill or sibling |
| Bidirectional | Rule → skill in Reference; skill → rule where paired |
| No duplication | SSOT in skill; rule has STOP rows or pointers only |
| Inventory drift | Tier-1 set discovered via the frontmatter audit in agents-tier-system rule — not hardcoded name lists in README/skill |
| Triggers | Per writing-great-skills — one branch per intent in description |
Rules cap at ≤40L; skills use progressive disclosure (writing-great-skills sprawl). Line count is a hygiene signal, not a hard gate — split for structure, not to hit a number.
| Lines | Target |
|---|---|
| ≤60 | Default for new skills |
| 61–120 | OK for one single-path workflow with checkable completion criteria |
| >120 | Audit — review for sprawl; disclose to siblings when structure says split |
| >140 | Split unless an explicit bulk reference hub (FULL-GUIDE.md, WORKFLOW.md, REFERENCE.md) |
Split when: branching paths, reference encyclopedia in SKILL.md, premature-completion risk, or sediment — disclose to siblings (WORKFLOW.md, REFERENCE.md, LANGUAGE.md, PROSE.md).
Don't split when: every line is ordered steps for one branch; splitting forces a multi-file hop mid-checklist.
# Review tail (>120L) — split only when table above says so
find .agents/skills -name SKILL.md -exec sh -c 'n=$(wc -l < "$1"); [ "$n" -gt 120 ] && printf "%3d %s\n" "$n" "$1"' _ {} \;
tracer-bullets (rule, single file), harden-pr (SKILL + WORKFLOW.md + LEDGER.md), docs-governance (SKILL + LIFECYCLE.md), docs-voice (skill + docs-voice-priming), product-tenets (skill-only), update-docs (skill-only, apps/docs sync), minimum-diff (user-only), improve-codebase-architecture (SKILL + LANGUAGE.md + REFERENCE.md), authoring-discipline (rule + PROSE.md), verify-after-each-step (slim rule + skill), agents-tier-system (rule + skill).
ask-agents — grill-me, grill-with-docs, teach, writing-great-skills, writing-agents-config, minimum-diff. Wrappers ≤10 lines.
agents-tier-system (.agents/rules/**, .agents/skills/**, .cursor/rules/**, .cursor/skills/**); docs-governance-priming (docs/**, .agents/**, .cursor/**); docs-voice-priming (apps/docs/**) — Persist keeps voice priming (Layers is skill-only) so competitor framing auto-loads on docs edits.improve-codebase-architecture, domain-modeling, docs-lifecycle-sweep, diagnosing-bugs, tdd, pr-comment-fact-check, harden-pr, update-docs. No glob (no per-file tax).../skill/SKILL.md and sibling files resolve reliably in Cursor agents. Relative links inside .agents/ are an intentional delta, not drift.docs/ subtrees, no UI-component skills, no API-client/codegen skills. Don't add a skill governing tooling this repo lacks (a rule referencing a nonexistent script is worse than no rule).src/core/; optional peers via subpath imports — see architecture-priming and product-tenets.ls + frontmatter audit)authoring-discipline)src/, seams, bun scripts, origin/maindocs-voice)writing-great-skillsagents-tier-systemdocs-governance