# Create Actionable Implementation Plans in Alan

Complex software changes need plans grounded in the existing codebase. This skill clarifies requirements, drafts visual plans, and stores versioned artifacts in Alan.

## Install

```bash
npx skillstore add supatest-ai/alan-plan
```

## Metadata

- Status: approved
- Slug: supatest-ai-alan-plan
- Version: 1.0.1
- Author version: 1.0.1
- Skillstore revision: r1
- Version status: valid
- Tree hash: 36dc4a7f3c6ae055b6d54ff664eb6ea5a576eeb926d83b67665f99b21b3977a5
- Author: supatest-ai
- GitHub username: supatest-ai
- License: MIT
- Repository: https://github.com/supatest-ai/alan-skills/tree/e6ebae2c86d4d3ad8597e588f3e820ab0c90658f/skills/alan-plan
- Ref: bdb71a4bc34515f37772ae85fd5501f9c2ff33b0
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 72
- Public page: https://skillstore.pages.dev/skills/supatest-ai-alan-plan
- Manifest: https://skillstore.pages.dev/api/skills/supatest-ai-alan-plan/manifest

## Capabilities

- Explores repository architecture, dependencies, constraints, and risks without modifying source files.
- Requests focused clarification when requirements remain ambiguous.
- Creates free-form implementation plans with file paths, functions, dependencies, and reasoning.
- Selects Mermaid sequence, schema, flowchart, state, C4, or data-flow diagrams when useful.
- Creates Alan plan artifacts and links revisions through parent artifact identifiers.

## Use Cases

- Plan a new product feature: Map affected modules, dependencies, risks, and validation work before implementation begins.
- Review an architecture change: Compare technical approaches and visualize service, schema, state, or data-flow changes.
- Revise a plan from feedback: Recheck assumptions, address review comments, and create a linked plan revision in Alan.

## Prompt Templates

### Create a basic plan

```
Create an implementation plan for [task]. Explore the repository without modifying files. Ask one question if a requirement is unclear.
```

### Plan a cross-module feature

```
Plan [feature] for this codebase. Identify affected files, dependencies, risks, and validation steps. Add a Mermaid diagram when relationships are complex.
```

### Revise an existing Alan plan

```
Review Alan plan [artifact reference] against this feedback: [feedback]. Recheck relevant code, resolve ambiguities, and create a versioned revision.
```

### Design a phased migration

```
Design a phased migration from [current state] to [target state]. Compare alternatives, map system changes, sequence dependencies, and document rollback decisions.
```

## Limitations

- Requires configured Alan MCP tools and valid task, conversation, and team context.
- Creates plans but does not implement changes or modify source files.
- Plan quality depends on accessible repository context and clear requirements.
- Persisted plans may contain internal architecture details and require appropriate Alan access controls.

## Best Practices

- Provide the task goal, constraints, and relevant Alan artifact references.
- Answer clarification questions before requesting the final plan.
- Review plan content for secrets and sensitive architecture before external persistence.

## Anti Patterns

- Do not request implementation or source-file changes from this planning skill.
- Do not provide unrelated artifact identifiers or substitute one Alan context identifier for another.
- Do not force diagrams for trivial changes with no meaningful relationships.

## Security Audit

- Audited at: 2026-08-20T08:31:35.049\+00:00
- Summary: All 29 static findings are false positives caused by Markdown backticks, fenced examples, Mermaid labels, and ordinary prose. No shell execution, system reconnaissance, or prompt injection appears in SKILL.md. The remaining medium risk is intended external persistence of repository-derived plans and context identifiers to Alan.

## Stats

- Views: 0
- Downloads: 1
- Favorites: 0
- Popularity score: 0