agents-tier-system
Full tier assignments, pairing conventions, and authoring checklist for .agents/ rules and skills. Use when creating or reviewing a rule or skill, deciding Tier 1 vs 2 vs 3, or auditing attachment cost.
- License 许可
- MIT
- 最近更新
- 2026-11-01
- Stars
- ★ 5
- Forks
- 0
01 前言 Front Matter
- name
- agents-tier-system
- description
- Full tier assignments, pairing conventions, and authoring checklist for .agents/ rules and skills. Use when creating or reviewing a rule or skill, deciding Tier 1 vs 2 vs 3, or auditing attachment cost.
03 SKILL.md 正文
.agents/ tier system — full reference
Always-on priming: .agents/rules/agents-tier-system.md. Entry points: .agents/README.md, agents-first-convention, writing-agents-config.
Discover on disk (do not maintain partial catalogs here)
| Tier | How to list |
|---|---|
| Tier 1 | Frontmatter audit in agents-tier-system rule — budget set there |
| Tier 2 | ls .agents/rules/*.md + globs: in frontmatter |
| Tier 3 | alwaysApply: false, no globs: — intent via description |
| Skills | ls .agents/skills — runtime discovery via descriptions |
Pairing examples in this repo: architecture-priming ↔ improve-codebase-architecture; docs-governance-priming ↔ docs-governance + docs-lifecycle-sweep; docs-voice-priming ↔ docs-voice; agents-tier-system rule + skill; authoring-discipline rule + PROSE; verify-after-each-step rule + skill.
Caution: avoid stacking broad globs without thin priming bodies.
Authoring guidelines
Adding a new rule
- Decide the tier before writing.
- Tier 1 needs justification — every turn? If file/intent scoped, demote to Tier 2 or Tier 3.
- Tier 2 globs — broadest meaningful scope; pair with skill when applicable.
- Layout per
agents-first-convention— rules: source +.mdcsymlink; skills:.agents/only.
Adding a new skill
- Needs a rule? Hard
NEVER/ALWAYS+ file-scoped work → Tier 2 priming rule. - Skill-only — explicit trigger phrases in description.
- User-only orchestrator —
disable-model-invocation: true+ delegate to model skill. - Size —
writing-agents-config§ SKILL.md size tiers.
Tier 1 audit command
for f in .agents/rules/*.md .agents/lessons.md; do
awk '/^---$/{c++; next} c==1 && /^alwaysApply: true$/{found=1; exit} END{exit !found}' "$f" && echo "$f"
done
Done when: tier choice justified; pairing checklist satisfied; Tier-1 audit command run when adding always-on rules.
Reference
- Skill authoring SSOT:
writing-great-skills - Persist deltas:
writing-agents-config - File-layout:
agents-first-convention.md - Tier-1 priming rule:
.agents/rules/agents-tier-system.md
04 同仓库更多 Skills
vue-persist
Gate Vue 3 UI on Persist hydration with useHydrated (shallowRef). Use in setup/effectScope when avoiding flash of default state on async backends.
svelte-store-persist
Gate Svelte store-based UI on Persist hydration with hydratedStore (Readable). Use for Svelte 3–4 or Svelte 5 apps that still use stores; runes UI → svelte-persist.
svelte-persist
Gate Svelte 5 runes UI on Persist hydration with hydratedRune (.current). Use for Svelte 5; for stores / Svelte 3–4 use svelte-store-persist.
solid-persist
Gate Solid UI on Persist hydration with useHydrated (Accessor). Use when avoiding flash of default state on async backends; read hydrated() in reactive scopes.
react-persist
Gate React UI on Persist hydration with useHydrated + toHydrationSignal. Use when avoiding flash of default state on async backends (IndexedDB), SSR snapshot true, or wiring HydrationSignal into React 18/19.
preact-persist
Gate Preact UI on Persist hydration with useHydrated (preact/compat useSyncExternalStore). Use when avoiding flash of default state on async backends or wiring HydrationSignal into Preact.