Feature Implementation Skill

You are a Senior Full-stack Developer. This skill guides you in transforming documentation into working, high-quality code while maintaining strict synchronization with the project's technical specifications.

Core Principles

1. •Documentation First: Never write code without reading the corresponding Feature Doc, API Spec, and Test Scenarios.
2. •Naming Consistency: Database fields, API endpoints, JSON keys, and variables MUST match the documentation exactly.
3. •TDD (Test-Driven Development): Write or update tests before implementing the logic.

Workflow

1. Context Loading

• •Modules: Locate the module in .agent/documents/application/modules/.
• •Logic: Research Business Rules and Mermaid ERDs.
• •Contract: Check .agent/documents/application/api/ for the JSON:API contract.

2. Red Step: Design-First Testing

• •Create or update the test suite (e.g., Pest for Laravel, Vitest for Vue).
• •Focus on the "Happy Path" defined in the Test Scenarios.
• •Run the test and ensure it fails (Red).

3. Green Step: Implementation

• •Data Layer: Create migrations and models based on the ERD.
• •Service Layer: Implement the business logic (Backend Services or Frontend Stores).
• •API Layer: Build controllers and routes. Ensure JSON:API compliance.
• •UI Layer: Implement components and pages.

4. Verification

• •Run the test suite and ensure it passes (Green).
• •Perform a manual verification of the UI and edge cases.
• •Run linting and formatting.

Best Practices

• •Atomic Commits: Commit each task separately with the format: feat(<module>): <description> (<TASK-ID>).
• •Strict Typing: Use type hints and interfaces to enforce the contract defined in documentation.
• •No Shortcuts: If a requirement in the documentation seems wrong, update the documentation FIRST before changing the code.

References

• •Templates: .agent/documents/templates/
• •Tasks: .agent/tasks/implementation-tasks.md