| name | best-practices |
| description | Activate when starting new work to check for established patterns. Activate when ensuring consistency with team standards or when promoting successful memory patterns. Searches and applies best practices before implementation. |
Best Practices Skill
Search and apply established best practices before implementation.
When to Use
- Starting new implementation work
- Checking for established patterns
- Promoting successful memory patterns
- Ensuring consistency with team standards
Best Practices Location
Best practices are stored in best-practices/<category>/:
best-practices/architecture/
best-practices/development/
best-practices/git/
best-practices/operations/
best-practices/quality/
best-practices/security/
best-practices/collaboration/
Search Before Implementation
MANDATORY: Check best-practices AND memory before starting work:
-
Identify the domain/category of work
-
Search best-practices directory:
find best-practices/<category>/ -name "*.md"
-
Search memory for related patterns:
memory search: "<relevant keywords>"
(CLI fallback: node ./.claude/skills/memory/cli.js search "<relevant keywords>" for project installs,
or node ~/.claude/skills/memory/cli.js search "<relevant keywords>" for user installs.)
-
Apply established patterns to implementation
-
Note deviations with justification
Best Practice Format
# [Practice Name]
## When to Use
[Situations where this practice applies]
## Pattern
[The recommended approach]
## Example
[Concrete implementation example]
## Rationale
[Why this approach is preferred]
## Anti-patterns
[What to avoid]
Promotion from Memory
When a memory pattern proves successful:
- Threshold: Used 3+ times successfully
- Validation: Pattern is generalizable
- Documentation: Full best-practice format
- Location: Move to appropriate category
- References: Update memory to link to best-practice
Integration with AgentTasks
When creating AgentTasks, reference applicable best practices:
context:
best_practices:
- category: security
practice: input-validation
- category: git
practice: commit-messages
Categories
| Category | Focus |
|---|
| architecture | System design patterns |
| collaboration | Team workflow patterns |
| development | Coding standards |
| git | Version control practices |
| operations | Deployment/monitoring |
| quality | Testing/review practices |
| security | Security patterns |