-
Notifications
You must be signed in to change notification settings - Fork 0
Catalog
Every official pack — rules, agents, skills, and guardrails — and the items it contains.
Item names match filenames in each pack's llm/<kind>/ directory and are used for local overrides.
Always-on instructions loaded into every AI session automatically.
Agent memory rules for Bluetemberg — statelessness as a hard constraint, memory provenance, promotion through consolidation, and authority-ranked recall.
| Rule | Enforces |
|---|---|
memory-architecture-checklist |
Treat LLM statelessness as a hard constraint — decide explicitly what state survives a turn, which storage tier holds it, and how it is evicted. |
memory-promotion |
Session observations never write directly to durable memory — promotion runs through a reviewable consolidation step that dedupes, supersedes, and ratifies. |
memory-provenance |
Every durable memory carries provenance — source, time, confidence, and whether it was user-stated or agent-inferred. No silent writes. |
memory-recall-authority |
Rank recalled memory by authority, not only relevance — and never let stale, contradicted, or superseded memory present as a current constraint. |
Context engineering rules for Bluetemberg — structuring LLM context, managing token budgets, avoiding context pollution.
| Rule | Enforces |
|---|---|
context-pollution-prevention |
Prevent context pollution — scope tool calls to what you need, don't inject noise into the conversation. |
context-positioning |
Place load-bearing content at the edges of the context, not the middle — models access the start and end far better than the middle. |
context-window-budget |
Manage context window budget explicitly — prune stale content, compress retrieved data, never let context grow unbounded. |
multi-turn-context-hygiene |
Don't keep talking to a derailed conversation — consolidate the requirements and restart fresh. Multi-turn degradation is large and doesn't self-correct. |
multi-turn-state-management |
Manage state across multi-turn interactions — track what was decided, what changed, and what is still open. |
prompt-structure |
Structure prompts into labeled, delimited sections — separate instructions from data, and keep persistent rules in the system message. |
Infrastructure rules for Bluetemberg — Docker, Terraform, Ansible, Kubernetes, Helm, CI/CD, shell scripts, and idempotency.
| Rule | Enforces |
|---|---|
ansible-conventions |
Follow Ansible best practices for idempotent, maintainable infrastructure automation. |
ci-workflow-conventions |
Secure CI/CD workflows with minimal permissions, pinned actions, and OIDC authentication. |
container-image-pinning |
Pin container image versions to prevent unexpected breaking changes. |
docker-best-practices |
Follow container best practices for secure, efficient Docker images. |
helm-conventions |
Write safe, reusable Helm charts with secure defaults and consistent values structure. |
idempotency |
Every operation — task, script, or deployment — must be safe to re-run without side effects. |
jinja2-templates |
Write safe, readable Jinja2 templates for Ansible and configuration generation. |
kubernetes-manifests |
Write safe, production-grade Kubernetes manifests with resource limits, health checks, and security context. |
runbook-discipline |
Keep operational runbooks and ADRs accurate and commit them alongside the changes they document. |
shell-script-standards |
Write safe, portable shell scripts with error handling and clear control flow. |
terraform-conventions |
Follow Terraform module structure and naming conventions. |
Documentation and diagnostics rules for Bluetemberg — docs parity, post-edit diagnostics, Mermaid diagrams.
| Rule | Enforces |
|---|---|
docs-parity |
Keep documentation in sync with every user-facing change. |
mermaid-diagrams |
Use Mermaid diagrams instead of ASCII art. |
post-edit-diagnostics |
Run diagnostics and formatter after editing code files. |
Git workflow rules for Bluetemberg — branch protection, naming, PR workflow, git move, pre-commit checks.
| Rule | Enforces |
|---|---|
git-move |
Use git mv for tracked files to preserve history. |
git-workflow |
Branch protection, branch naming, and PR workflow rules. |
pre-commit-checks |
Run formatter, linter, and build checks before every commit. |
LLM API and product-engineering rules for Bluetemberg — streaming, cost accounting, and cost-aware model selection.
| Rule | Enforces |
|---|---|
cost-accounting |
Measure LLM cost from the authoritative usage object and the provider's cost API — never from your own token estimates. |
model-selection-and-routing |
Pick models on the accuracy-vs-cost frontier and route easy queries to cheaper models — the most expensive model is rarely the right default. |
streaming |
Stream for perceived latency, but buffer tool-call JSON until the block closes and don't gate safety on partial output. |
Next.js rules for Bluetemberg — NEXT_PUBLIC_* env var safety.
| Rule | Enforces |
|---|---|
nextjs-data-fetching |
Prefer fetch with cache options in Server Components over useEffect + API calls |
nextjs-image-optimization |
Always use next/image; never raw img tags |
nextjs-metadata |
Define metadata/generateMetadata per page; never use in App Router |
nextjs-public-env-vars |
NEXT_PUBLIC_* are inlined into the bundle at build time — never use for secrets or per-environment values. |
nextjs-server-components |
Default to React Server Components; use 'use client' only at leaf interactive nodes |
Security guardrail rules for Bluetemberg — secrets management, environment file protection, API error handling.
| Rule | Enforces |
|---|---|
api-error-handling |
Use structured error responses and never leak internal details. |
llm-package-hallucination |
Verify every LLM-suggested dependency exists in the registry before installing — hallucinated package names are a real supply-chain attack surface (slopsquatting). |
never-read-env |
Never read .env files directly in code. |
security-secrets |
Never hardcode secrets, tokens, or credentials in source code. |
TypeScript code quality rules for Bluetemberg — type safety, coding standards, early returns, no console.log, design system reuse.
| Rule | Enforces |
|---|---|
coding-standards |
Keep functions and components small, readable, and easy to reason about. |
design-system-reuse |
Reuse existing shared UI components and design tokens before creating new ones. |
early-returns |
Prefer early returns and guard clauses over nested conditionals. |
no-console-log |
Forbid console.log in production code; use a logger instead. |
type-safety |
Enforce strict type safety — no implicit any, no unguarded assertions. |
Specialist agents invoked for focused, domain-specific tasks.
Accessibility specialist agent for Bluetemberg — WCAG 2.2 A/AA audit and remediation.
| Agent | Description |
|---|---|
a11y-specialist |
Audits and remediates accessibility issues against WCAG 2.2 A/AA standards. |
Agentic systems specialist agent for Bluetemberg — agent memory design, state management, orchestration patterns.
| Agent | Description |
|---|---|
agentic-specialist |
Designs and implements agentic system memory, state management, and agent-to-agent communication patterns. |
Ansible specialist agent for Bluetemberg — roles, playbooks, and Jinja2 templates.
| Agent | Description |
|---|---|
ansible-specialist |
Writes and reviews Ansible roles, playbooks, and Jinja2 templates for idempotent infrastructure automation. |
Backend specialist agent for Bluetemberg — API design, database patterns, error handling, auth.
| Agent | Description |
|---|---|
backend-specialist |
Implements and reviews backend services, APIs, database patterns, and auth flows. |
Code reviewer agent for Bluetemberg — PR review covering patterns, naming, complexity, tests.
| Agent | Description |
|---|---|
code-reviewer |
Reviews pull requests for code quality, patterns, naming, and potential bugs. |
DevOps specialist agent for Bluetemberg — CI/CD pipelines, container optimization, IaC review.
| Agent | Description |
|---|---|
devops-specialist |
Manages CI/CD pipelines, container builds, infrastructure-as-code, and deployment config. |
Docs maintainer agent for Bluetemberg — documentation synchronization with code changes.
| Agent | Description |
|---|---|
docs-maintainer |
Keeps documentation aligned with code and workflow changes. |
Frontend specialist agent for Bluetemberg — UI implementation, design-system, i18n, accessibility.
| Agent | Description |
|---|---|
frontend-specialist |
Implements and refactors frontend UI with reusable, accessible, and testable patterns. |
Infrastructure specialist agent for Bluetemberg — build, CI, container, deployment config.
| Agent | Description |
|---|---|
infrastructure-specialist |
Maintains build, CI, container, and deployment configuration. |
Kubernetes specialist agent for Bluetemberg — manifests, Helm charts, Kustomize overlays.
| Agent | Description |
|---|---|
kubernetes-specialist |
Writes and reviews Kubernetes manifests, Helm charts, and Kustomize overlays for secure, production-grade deployments. |
Security specialist agent for Bluetemberg — vulnerability audit, dependency scanning, secrets.
| Agent | Description |
|---|---|
security-specialist |
Audits code for security vulnerabilities, secrets exposure, and dependency risks. |
SRE specialist agent for Bluetemberg — SLOs, alerting, runbooks, and post-mortems.
| Agent | Description |
|---|---|
sre-specialist |
Designs SLOs, alerts, on-call runbooks, and reliability improvements for production services. |
Test specialist agent for Bluetemberg — test creation, refactoring, and stabilization.
| Agent | Description |
|---|---|
test-specialist |
Creates, refactors, and stabilizes automated tests with deterministic patterns. |
On-demand workflows triggered by slash commands.
API design skill for Bluetemberg — RESTful conventions, pagination, versioning.
| Skill | Description |
|---|---|
api-design |
Apply RESTful API design conventions for endpoints, pagination, versioning, and error contracts. |
CI/CD best practices skill for Bluetemberg — pipeline optimization and caching strategies.
| Skill | Description |
|---|---|
ci-cd-best-practices |
Optimize CI/CD pipeline configuration for speed, reliability, and caching. |
Code review skill for Bluetemberg — structured review checklist for PRs.
| Skill | Description |
|---|---|
code-review |
Structured code review — intent-first, diff-focused, severity-tiered findings with actionable fix suggestions. |
Config echo skill for Bluetemberg — verifies that synced configuration was actually loaded by the LLM.
| Skill | Description |
|---|---|
config-echo |
Verify that bluetemberg configuration was actually loaded by the LLM — recall rules, agents, and skills from session context and cross-reference against disk. |
Meta-skill for scaffolding new bluetemberg agents — frontmatter, scoped tools, responsibilities and constraints, and sync.
| Skill | Description |
|---|---|
create-agent |
Scaffold a new bluetemberg agent in the correct format — frontmatter with scoped tools, responsibilities, constraints, and sync. |
Meta-skill for scaffolding a whole new bluetemberg pack — package.json metadata, llm/ layout, catalog registration, and validation.
| Skill | Description |
|---|---|
create-pack |
Scaffold a whole new bluetemberg pack — package.json metadata, llm/ layout, catalog registration, and validation. |
Meta-skill for scaffolding new bluetemberg rules — frontmatter, the Why/Rules/BAD-GOOD/config/gotchas structure, and sync.
| Skill | Description |
|---|---|
create-rule |
Scaffold a new bluetemberg rule in the correct format — frontmatter, a Why/Rules/BAD-GOOD/config/gotchas body, and sync. |
Meta-skill for scaffolding new bluetemberg skills — frontmatter, five required sections, and sync.
| Skill | Description |
|---|---|
create-skill |
Scaffold a new bluetemberg skill in the correct format — frontmatter, five required sections, and sync. |
Docs upkeep skill for Bluetemberg — keep docs aligned with implementation changes.
| Skill | Description |
|---|---|
docs-upkeep |
Keep canonical documentation aligned with implementation and workflow changes in the same task. |
Infrastructure drift check skill for Bluetemberg — verify IaC state matches deployed state.
| Skill | Description |
|---|---|
infrastructure-drift-check |
Verify that declared infrastructure state matches deployed state before merging IaC changes. |
Migration safety skill for Bluetemberg — database migration review and rollback plans.
| Skill | Description |
|---|---|
migration-safety |
Review database migrations for safety, rollback capability, and zero-downtime compatibility. |
Patterns skill for Bluetemberg — apply reusable architecture and coding patterns.
| Skill | Description |
|---|---|
patterns |
Apply reusable architecture and coding patterns from project standards when implementing features or reviewing structure. |
React patterns skill for Bluetemberg — component composition, hook extraction, state co-location.
| Skill | Description |
|---|---|
react-patterns |
Apply React component patterns — composition, co-location, and hook extraction — before reaching for custom solutions. |
Rollback plan skill for Bluetemberg — require tested rollback steps for every production change.
| Skill | Description |
|---|---|
rollback-plan |
Require an explicit rollback plan for every infrastructure or deployment change before merge. |
Security audit skill for Bluetemberg — dependency audit, secrets scan, OWASP patterns.
| Skill | Description |
|---|---|
security-audit |
Run a security audit checklist against code changes for secrets, injection, and dependency risks. |
Stack change review skill for Bluetemberg — high-blast-radius infrastructure change review.
| Skill | Description |
|---|---|
stack-change-review |
Review high-blast-radius infrastructure changes for safety before merge. |
Sub-agent design skill for Bluetemberg — plan, scope, and implement sub-agent architectures.
| Skill | Description |
|---|---|
sub-agent-design |
Design a sub-agent system — scope responsibilities, define communication contracts, wire orchestration, and add integration tests. |
Workspace hygiene skill for Bluetemberg — clean workspace state during edits.
| Skill | Description |
|---|---|
workspace-hygiene |
On-demand workspace audit — review change scope, clean temp artifacts, verify commit focus. |
Hook-based constraints that fire automatically during AI operations.
Git guardrails for Bluetemberg — enforce conventional branch names on AI-created worktrees.
| Guardrail | Description |
|---|---|
conventional-branch-names |
Enforce conventional branch names before creating a worktree |
Every rule is a self-contained Markdown file. To change one for your project without forking the pack,
create a file with the same name in your local llm/rules/ — it takes priority over the pack version
during sync. See Usage for the full priority order.