# ByteLyst Ecosystem — Reusable AI Prompts

> **Location:** `AI.dev/PROMPTS/`
> **Audience:** Claude Code, Codex, Cursor, Copilot, Windsurf Cascade, Gemini, and any AI coding agent.
> **Scope:** All 37 repos in `D:\BYTELYST\CODE\` — common platform, product repos, tooling repos.

---

## How to Use

Copy-paste a prompt into your AI assistant, or reference it by path:

```
@file AI.dev/PROMPTS/roadmap-execution.md
```

Each prompt is **self-contained** — it includes the context the agent needs without
requiring you to manually explain the ecosystem every time.

## Prompt Index

### 🗺️ Planning & Roadmap

| Prompt | Purpose |
|--------|---------|
| [roadmap-execution.md](./roadmap-execution.md) | Execute a phased roadmap with checkpoints, commits, and validation |
| [new-product-scaffold.md](./new-product-scaffold.md) | Scaffold a new ByteLyst product repo from scratch |
| [prd-to-implementation.md](./prd-to-implementation.md) | Convert a PRD into a concrete, phased implementation plan |

### 🔧 Development & Debugging

| Prompt | Purpose |
|--------|---------|
| [cross-repo-debug.md](./cross-repo-debug.md) | Systematically debug issues spanning multiple repos |
| [backend-module-crud.md](./backend-module-crud.md) | Add a complete Fastify CRUD module (types → repo → routes → tests) |
| [platform-integration.md](./platform-integration.md) | Wire a product repo into the common platform ecosystem |
| [refactor-with-tests.md](./refactor-with-tests.md) | Safely refactor code with test-first methodology |

### 🧪 Quality & Testing

| Prompt | Purpose |
|--------|---------|
| [test-gap-analysis.md](./test-gap-analysis.md) | Identify and fill test coverage gaps in any repo |
| [type-safety-sweep.md](./type-safety-sweep.md) | Fix TypeScript errors across a repo or the workspace |
| [dependency-health-check.md](./dependency-health-check.md) | Audit and update dependencies across repos |

### 📦 Release & Ops

| Prompt | Purpose |
|--------|---------|
| [pre-release-validation.md](./pre-release-validation.md) | Full pre-release checklist: build, test, lint, security |
| [docker-production-prep.md](./docker-production-prep.md) | Prepare Docker images for production deployment |

### 📚 Documentation

| Prompt | Purpose |
|--------|---------|
| [agents-md-sync.md](./agents-md-sync.md) | Update AGENTS.md across all repos to match current state |
| [ecosystem-audit.md](./ecosystem-audit.md) | Full ecosystem health audit with actionable report |

---

## Conventions

- **Agent-agnostic:** Prompts work across Claude, Copilot, Cursor, Windsurf, Gemini.
- **Ecosystem-aware:** Each prompt embeds the key ByteLyst conventions (productId, Fastify module pattern, @bytelyst/* packages, pnpm workspace).
- **Commit-friendly:** Prompts that produce code changes include commit message guidance.
- **Incremental:** Each prompt favors small, validated, committed steps over big-bang changes.

## Adding a New Prompt

1. Create `AI.dev/PROMPTS/<prompt-name>.md`
2. Include a YAML-style header with `name`, `description`, `argument-hint`
3. Add it to this index
4. Commit: `docs(prompts): add <prompt-name> reusable prompt`
