Codex (or any other coding agent) initial prompt.

inital_codex_prompt.md

This prompt require two things – detailed project_prd.md, and AGENTS.md with all additional instructions. 
Some of instructions aka rules I prefer are also mentioned in this prompt. 

ATTENTION: You likely shuld adopt this prompt for YOUR project needs, espetially list in `Development Phases`
But I highly encourage you to preserve all the mentioned development principles.

Implementation Planning Task

You are tasked with creating a comprehensive implementation plan for the project based on the provided documentation.

Required Analysis

1. Thoroughly analyze both AGENTS.md and project_prd.md
2. Extract core requirements from the PRD including all functional and technical specifications
3. Understand development principles from AGENTS.md, especially:
   • Functional programming approach
   • Test-Driven Development (TDD) methodology
   • Interface-based testing philosophy
   • Type safety and schema validation requirements

Implementation Plan Requirements

Create a detailed implementation plan saved as IMPLEMENTATION_PLAN.md with the following structure:

1. Project Overview

• Brief summary of the system architecture
• Key technologies and their roles
• Critical success criteria

2. Development Phases

Break down implementation into 4 phases matching the PRD:

• Phase 1: Core Infrastructure
• Phase 2: Analysis Enhancement
• Phase 3: User Experience
• Phase 4: Future Enhancements

3. Detailed Task Breakdown

For each phase, create atomic, testable tasks with:

• Task Name
  • Description: What needs to be implemented
  • Acceptance Criteria: Specific, testable requirements
  • Dependencies: What must be completed first
  • Testing Strategy: How this will be tested (following TDD)
  • Files/Modules: Where code will be placed

4. Technical Architecture Decisions

Document key architectural choices:

• Database schema implementation
• API endpoint design
• Service layer structure
• Error handling patterns
• Testing framework setup

5. Development Standards Checklist

Reference AGENTS.md principles:

• Functional programming patterns used
• Tests written before implementation (TDD)
• Interface contracts defined
• Type safety with Pydantic schemas
• Pure functions over classes
• Proper error handling with Result types

This checklist MUST be included in every task of every phase to focus agent attention on these rules.

Critical Requirements

1. Each task must be implementable in isolation - no monolithic features
2. Follow TDD cycle: Write failing test → Implement → Refactor
3. Prioritize functional approach over OOP wherever possible
4. Include comprehensive testing strategy for each component
5. Specify exact file structure following the project layout
6. Account for all PRD requirements - nothing should be missed
7. Create trackable progress - use checkbox format for easy updates

Deliverable Format

The plan should be formatted as a living document that can be updated as tasks are completed. Use clear markdown with:

• Checkboxes for progress tracking
• Code blocks for technical specifications
• Tables for complex data relationships
• Clear hierarchical structure with proper headings

Start with a thorough analysis, then proceed to create the comprehensive implementation plan. Focus on creating a roadmap that any developer following AGENTS.md principles can execute successfully.