# Plan Module

> A Claude skill from Karthick-Ramachandran/persist-os.

- **Type:** Skill
- **Install:** `agentstack add skill-karthick-ramachandran-persist-os-plan-module`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Karthick-Ramachandran](https://agentstack.voostack.com/s/karthick-ramachandran)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Karthick-Ramachandran](https://github.com/Karthick-Ramachandran)
- **Source:** https://github.com/Karthick-Ramachandran/persist-os/tree/main/.claude/skills/plan-module
- **Website:** https://persist-os.pages.dev

## Install

```sh
agentstack add skill-karthick-ramachandran-persist-os-plan-module
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill: Plan Module

## Purpose

Turn a module request into a complete delivery workflow before implementation starts.

## Inputs

- Module name or request.
- Product goal or user need.
- Existing architecture, feature, or module docs.
- Known constraints or priority stage.

## Required Reading

- `AGENTS.md`
- `docs/00-product/PRD.md`
- `docs/10-architecture/ARCHITECTURE.md`
- `docs/20-security/SECURITY_MODEL.md`
- `docs/50-quality/TESTING_STRATEGY.md`
- `docs/60-engineering/ENGINEERING_STANDARDS.md`
- `docs/ai/MODULE_DELIVERY_WORKFLOW.md`
- Relevant ADRs under `docs/adrs/`

## Output Files

- `docs/40-features/F-###--module/` delivery docs (PRD, ACCEPTANCE, ARCHITECTURE_IMPACT,
  PLAN, TASKS, TEST_PLAN, REVIEW, COMPLETION_REPORT).
- `docs/30-modules//MODULE.md`
- `docs/30-modules//TASKS.md`
- `docs/30-modules//TEST_PLAN.md`
- `docs/30-modules//DECISIONS.md`

## Process

1. Create a module brief: ownership, non-ownership, public interfaces, users, and use cases.
2. Define behavior and edge cases.
3. Write testable acceptance criteria.
4. Document architecture impact, dependency impact, config impact, template impact, and ADR needs.
5. Write the test plan from acceptance criteria, security invariants, and regression risk.
6. Break work into ordered tasks with status, scope, acceptance, tests, and do-not-do boundaries.
7. Mark implementation as blocked until the first task is selected.

## Stop Conditions

Stop and request human decision if:

- The module ownership or public interface is unclear.
- The module conflicts with accepted ADRs or architecture docs.
- The module conflicts with engineering standards.
- The module requires runtime network, telemetry, cloud, MCP, AI API, auth, secrets, storage, or
  file write behavior changes without ADR or security review.
- The user asks to implement before PRD, acceptance, architecture impact, test plan, and tasks
  exist.

## Quality Bar

- The module is planned as a mini product, not a file list.
- PRD, acceptance, architecture impact, test plan, and tasks are all present.
- Tasks are small enough to execute one at a time.
- Module memory captures what future agents need to remember.
- No implementation code is written by this skill.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Karthick-Ramachandran](https://github.com/Karthick-Ramachandran)
- **Source:** [Karthick-Ramachandran/persist-os](https://github.com/Karthick-Ramachandran/persist-os)
- **License:** MIT
- **Homepage:** https://persist-os.pages.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-karthick-ramachandran-persist-os-plan-module
- Seller: https://agentstack.voostack.com/s/karthick-ramachandran
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.