- Updated AGENTS.md with CRITICAL GUARDRAILS section
- Added explicit rules: NEVER write new .spec.ts or .stories.tsx files
- Tests must be JSON in packages/{name}/playwright/tests.json
- Stories must be JSON in packages/{name}/storybook/stories.json
- Updated CLAUDE.md with same guardrails at top (highly visible)
- Created TEST_STORY_CONVERSION.md with conversion guide and examples
- Converted smoke.spec.ts → packages/smoke_tests/playwright/tests.json
- Converted login.spec.ts → packages/auth/playwright/tests.json
- Documented all existing test files that can be converted
- Confirmed no leftover junk (generators removed, codebase clean)
- JSON tests auto-discovered and executed by e2e/json-runner/
- JSON stories auto-discovered and rendered by storybook/json-loader/
Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
Add explicit, step-by-step instructions for each tech debt item so bots know exactly what to do:
- TD-1: DBAL Refactoring (🔴 CRITICAL) - Move database logic from frontend to DBAL (13 steps)
- TD-2: Rate limiting (🟡 HIGH) - Protect API endpoints from abuse
- TD-3: OpenAPI/Swagger (🟡 HIGH) - API contract visibility and client generation
- TD-4: Error handling docs (🟡 MEDIUM) - Consistent error response patterns
Also included 9 Phase 3+ tasks (TD-5 through TD-13) for future reference.
Each task includes:
- Current status and priority
- Clear problem statement
- Impact analysis
- Bot-actionable instructions (step-by-step)
- Expected outcomes
Updated ROADMAP.md, CLAUDE.md, and AGENTS.md to reference TECH_DEBT.md.
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Introduced a comprehensive AGENTS.md at the project root to provide unified guidance for all AI agents, covering core principles, DBAL, frontend, package development, testing, deployment, and troubleshooting. Updated CLAUDE.md to reference the new AGENTS.md location and its expanded scope, clarified the pattern for scoped rules, and improved quick reference tables. Replaced dbal/docs/AGENTS.md with a redirect notice pointing to the new root AGENTS.md. Minor update to .claude/settings.local.json to allow 'tree' command.
- Introduced UI Standards document to enforce Material-UI and SASS usage.
- Created Refactoring Summary detailing the conversion of large TypeScript files to JSON, improving maintainability and reducing code complexity.
- Added Dependency Update Summary outlining major version updates and API refactoring for Prisma and other dependencies.
- Documented Legacy Pipeline Cruft Analysis to identify redundant workflows post-implementation of gated workflows.
- Enhanced PR Summary for converting TODO items to GitHub issues with new scripts and automation workflows.
- Established Renovate Dependency Dashboard Status Report confirming successful dependency updates and compliance with UI standards.
