bytelyst/learning_ai_common_plat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
5606ccf1f7
learning_ai_common_plat/AI.dev/PROMPTS
History
saravanakumardb1 088a9cabd6 fix(agent-docs): update AI.dev guides + script UX after single-source migration 
Followup audit of the single-source-of-truth agent-docs rollout. Several
AI.dev prompts and skills still taught agents the old 8-file pattern (which
would re-introduce drift) and the generator script emitted a misleading
summary in --no-commit mode.

AI.dev guides:
- Delete AI.dev/SKILLS/update-agent-docs.md — entire doc taught the old
  8-file pattern. Canonical reference is now
  .windsurf/workflows/repo_update-agent-docs.md.
- AI.dev/SKILLS/index.md + README.md: replace dangling 'Update Agent
  Documentation' link with pointers to agent-behavior-guidelines.md,
  agent-onboarding.md, and the workflow doc.
- AI.dev/SKILLS/scan-repo-context.md: remove instructions to read
  .windsurfrules / write .cursorrules. Point at the canonical behavior file.
- AI.dev/PROMPTS/new-product-scaffold.md: remove .windsurfrules and CLAUDE.md
  from the scaffold tree. Add deprecated-files callout + regeneration hint.
- AI.dev/PROMPTS/agents-md-sync.md: drop 'Step 4 update CLAUDE.md', point at
  the generator instead. Remove CLAUDE.md from `git add`.
- AI.dev/PROMPTS/ecosystem-audit.md: replace 'CLAUDE.md exists?' with
  'canonical-behavior-pointer block present? legacy files absent?'.

Script UX:
- scripts/update-agent-docs.sh: stop printing 'All repos already in sync'
  when --no-commit suppressed commits or --dry-run was used. Emit accurate
  per-mode summaries instead.
2026-05-23 12:06:28 -07:00
..
agents-md-sync.md fix(agent-docs): update AI.dev guides + script UX after single-source migration 2026-05-23 12:06:28 -07:00
backend-module-crud.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
cross-repo-debug.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
dependency-health-check.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
docker-production-prep.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
ecosystem-audit.md fix(agent-docs): update AI.dev guides + script UX after single-source migration 2026-05-23 12:06:28 -07:00
new-product-scaffold.md fix(agent-docs): update AI.dev guides + script UX after single-source migration 2026-05-23 12:06:28 -07:00
platform-integration.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
prd-to-implementation.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
pre-release-validation.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
README.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
refactor-with-tests.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
roadmap_execution.md Add roadmap execution guidelines for full-stack engineers 2026-05-17 16:37:51 -07:00
roadmap-execution.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
test-gap-analysis.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00
type-safety-sweep.md docs(prompts): add 14 reusable AI prompts for ecosystem-wide workflows 2026-05-17 16:48:58 -07:00

README.md

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 Execute a phased roadmap with checkpoints, commits, and validation
new-product-scaffold.md Scaffold a new ByteLyst product repo from scratch
prd-to-implementation.md Convert a PRD into a concrete, phased implementation plan

🔧 Development & Debugging

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

🧪 Quality & Testing

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

📦 Release & Ops

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

📚 Documentation

Prompt Purpose
agents-md-sync.md Update AGENTS.md across all repos to match current state
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