Menu
Guide for writing task plans and implementation plans. Use when starting a new task, creating a plan file, or updating plan progress.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | plan-skill |
| description | Guide for writing task plans and implementation plans. Use when starting a new task, creating a plan file, or updating plan progress. |
.claude/tasks/<task-name>.md (git-ignored, local only).claude/plan.md (committed, project-level roadmap)# Task: <Title>
## Summary
<1-2 sentence description of what this task accomplishes>
## Context
<Why this task is needed, relevant background>
## Implementation Plan
### Step 1: <Structural/Behavioral> — <Description>
- <Detail>
- <Detail>
### Step 2: <Structural/Behavioral> — <Description>
- <Detail>
## Acceptance Criteria
- [ ] <Criterion 1>
- [ ] <Criterion 2>
- [ ] All tests pass (`uv run pytest`)
- [ ] Code quality checks pass (`uv run pre-commit run`)
## Status
- [ ] Step 1
- [ ] Step 2
- [x] Step 1plan.md)The project-level plan tracks milestones and phases. Update when:
Guide for writing Architecture Decision Records (ADR). Use when documenting architectural decisions, recording technology choices, or creating technical decision logs. This skill defines the ADR structure, format, and best practices.
Guide for creating and managing configuration classes in this project. Use when creating new config classes, loading configuration from environment variables, implementing domain-specific configs (Redis, OpenAI, S3, etc.), integrating with FastAPI or LangGraph, or working with sensitive field masking. This skill defines the two-type config system: Settings (SettingsBase) for app-level config and ConfigBase (BaseModel) for domain configs.
Guide for Kubernetes deployments with Helm charts. Use when working with Helm charts, managing secrets across environments (dev, beta, prod), creating SealedSecrets, or configuring environment-specific values. This skill defines the secret management workflow using Bitnami SealedSecrets.
Guide for managing pyproject.toml files in this uv workspace monorepo. Use when adding dependencies, creating new workspace members, or modifying build configuration.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Guide for writing and organizing tests in this project. Use when creating new tests, choosing test patterns, writing fixtures, or structuring test directories.