saravanakumardb
32c7b1ba7e
- roadmap-execution: phased roadmap execution with checkpoints - new-product-scaffold: scaffold new ByteLyst product repos - prd-to-implementation: convert PRDs to concrete plans - cross-repo-debug: systematic multi-repo debugging - backend-module-crud: Fastify CRUD modules (types/repo/routes/tests) - platform-integration: wire products into common platform - refactor-with-tests: test-first safe refactoring - test-gap-analysis: coverage gap identification and remediation - type-safety-sweep: TypeScript error triage and fix - dependency-health-check: cross-repo dependency audit - pre-release-validation: comprehensive release checklist - docker-production-prep: production Docker images - agents-md-sync: keep AI instruction files accurate - ecosystem-audit: full ecosystem health dashboard
76 lines
3.1 KiB
Markdown
76 lines
3.1 KiB
Markdown
# 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`
|