feat: add comprehensive architecture and tasks documentation

.replworks/ARCHITECTURE.md

@@ -0,0 +1,191 @@
+# architecture.md
+
+## PURPOSE
+
+DEFINE_PROJECT_DOCUMENT_ARCHITECTURE
+
+DEFINE_DOCUMENT_RESPONSIBILITIES
+
+DEFINE_DOCUMENT_RELATIONSHIPS
+
+---
+
+## PROJECT_DOCUMENTS
+
+```text
+ARCHITECTURE.md
+TASKS.md
+AGENTS.md
+```
+
+---
+
+## architecture.md
+
+PURPOSE
+
+DEFINE_SYSTEM_STRUCTURE
+
+DEFINE_COMPONENT_BOUNDARIES
+
+DEFINE_PROJECT_ORGANIZATION
+
+CONTAINS
+
+- components
+- layers
+- modules
+- data_flow
+- responsibility_boundaries
+
+QUESTION
+
+HOW_IS_THE_PROJECT_STRUCTURED
+
+---
+
+## framework.md
+
+PURPOSE
+
+DEFINE_IMPLEMENTATION_RULES
+
+DEFINE_TECHNICAL_CONSTRAINTS
+
+CONTAINS
+
+- stack
+- versions
+- directory_structure
+- file_placement
+- naming_rules
+- restrictions
+
+QUESTION
+
+HOW_SHOULD_THE_PROJECT_BE_IMPLEMENTED
+
+---
+
+## tasks.md
+
+PURPOSE
+
+TRACK_CURRENT_WORK
+
+TRACK_PROGRESS
+
+TRACK_NEXT_ACTIONS
+
+CONTAINS
+
+- active_tasks
+- completed_tasks
+- priorities
+- next_steps
+
+QUESTION
+
+WHAT_SHOULD_BE_DONE_NEXT
+
+---
+
+## AGENTS.md
+
+PURPOSE
+
+DEFINE_AGENT_BEHAVIOR
+
+DEFINE_EXECUTION_RULES
+
+DEFINE_DOCUMENT_LOADING_ORDER
+
+CONTAINS
+
+- workflow
+- validation_rules
+- execution_rules
+
+QUESTION
+
+HOW_SHOULD_THE_AGENT_OPERATE
+
+---
+
+## DOCUMENT_DEPENDENCIES
+
+```text
+ARCHITECTURE
+        ↓
+FRAMEWORK
+        ↓
+TASKS
+```
+
+AGENTS_READS_ALL_DOCUMENTS
+
+---
+
+## DOCUMENT_RESPONSIBILITIES
+
+ARCHITECTURE
+
+DEFINES_STRUCTURE
+
+---
+
+FRAMEWORK
+
+DEFINES_IMPLEMENTATION_CONSTRAINTS
+
+---
+
+TASKS
+
+DEFINES_CURRENT_WORK
+
+---
+
+AGENTS
+
+DEFINES_AGENT_BEHAVIOR
+
+---
+
+## FRAMEWORK_TEMPLATE_FLOW
+
+```text
+frameworks/REACT_VITE.md
+                ↓
+project/framework.md
+```
+
+FRAMEWORK_TEMPLATES_ARE_REUSABLE
+
+PROJECT_FRAMEWORK_MD_IS_PROJECT_SPECIFIC
+
+---
+
+## DESIGN_RULES
+
+AI_FIRST
+
+EXPLICIT_OVER_IMPLICIT
+
+CONSTRAINTS_OVER_EXPLANATIONS
+
+CONSISTENCY_OVER_FLEXIBILITY
+
+REUSE_OVER_REINVENTION
+
+---
+
+## CORE_PRINCIPLE
+
+ARCHITECTURE_DEFINES_STRUCTURE
+
+FRAMEWORK_DEFINES_CONSTRAINTS
+
+TASKS_DEFINE_EXECUTION
+
+AGENTS_DEFINE_BEHAVIOR

.replworks/TASKS.md

@@ -0,0 +1,189 @@
+# TASKS.md
+
+## CURRENT_GOAL
+
+Build a reusable AI-first documentation system for software projects.
+
+The system should allow developers to compose framework.md from framework specifications and package extensions.
+
+---
+
+## PHASE_1_FOUNDATION
+
+### Repository Structure
+
+- [ ] Define repository directory structure
+- [ ] Define naming conventions
+- [ ] Define document lifecycle
+- [ ] Define document loading order
+
+### Core Documents
+
+- [x] AGENTS.md
+- [x] IDEAS.md
+- [x] PITCHING_SCRIPT.md
+- [ ] architecture.md
+- [ ] AI_MEMORY.md
+- [ ] tasks.md refinement
+
+---
+
+## PHASE_2_FRAMEWORK_SPECIFICATIONS
+
+### React Ecosystem
+
+- [x] REACT_VITE.md
+- [x] ASTRO.md
+- [x] VANILLA.md
+- [ ] NEXTJS.md
+- [ ] REMIX.md
+
+### Laravel Ecosystem
+
+- [ ] LARAVEL.md
+
+### Python Ecosystem
+
+- [ ] FASTAPI.md
+- [ ] DJANGO.md
+
+### Additional Frameworks
+
+- [ ] NUXT.md
+- [ ] SVELTEKIT.md
+
+---
+
+## PHASE_3_EXTENSION_SPECIFICATIONS
+
+### React
+
+- [ ] REACT_ROUTER.md
+- [ ] I18NEXT.md
+- [ ] LUCIDE_REACT.md
+- [ ] ZUSTAND.md
+- [ ] TANSTACK_QUERY.md
+- [ ] REACT_HOOK_FORM.md
+- [ ] ZOD.md
+- [ ] AXIOS.md
+
+### Laravel
+
+- [ ] LIVEWIRE.md
+- [ ] INERTIA.md
+- [ ] FILAMENT.md
+- [ ] PEST.md
+
+### Shared
+
+- [ ] DOCKER.md
+- [ ] GITHUB_ACTIONS.md
+
+---
+
+## PHASE_4_DOCUMENT_STANDARDS
+
+### Framework Specification Standard
+
+- [ ] Define required sections
+- [ ] Define version policy
+- [ ] Define structure policy
+- [ ] Define generation policy
+
+### Extension Specification Standard
+
+- [ ] Define extension format
+- [ ] Define activation rules
+- [ ] Define merge rules
+- [ ] Define conflict rules
+
+---
+
+## PHASE_5_COMPOSITION_SYSTEM
+
+### Framework Assembly
+
+- [ ] Design framework.md generation flow
+- [ ] Design extension loading flow
+- [ ] Design merge strategy
+- [ ] Design override strategy
+
+### Package Detection
+
+- [ ] Detect installed packages
+- [ ] Map packages to extensions
+- [ ] Support manual extension selection
+
+---
+
+## PHASE_6_CLI
+
+### Commands
+
+- [ ] replworks init
+- [ ] replworks framework
+- [ ] replworks extension
+- [ ] replworks build-framework
+- [ ] replworks update-framework
+
+### Generation
+
+- [ ] Generate framework.md
+- [ ] Generate project documents
+- [ ] Update existing documents
+
+---
+
+## PHASE_7_VALIDATION
+
+### AI Testing
+
+- [ ] Test with ChatGPT
+- [ ] Test with Claude
+- [ ] Test with Gemini
+- [ ] Test with Cursor
+
+### Framework Validation
+
+- [ ] React/Vite validation
+- [ ] Next.js validation
+- [ ] Laravel validation
+- [ ] FastAPI validation
+
+### Extension Validation
+
+- [ ] Router validation
+- [ ] i18n validation
+- [ ] State management validation
+
+---
+
+## FUTURE
+
+### Marketplace
+
+- [ ] Community specifications
+- [ ] Community extensions
+
+### Automation
+
+- [ ] Auto-detect framework
+- [ ] Auto-detect packages
+- [ ] Auto-generate framework.md
+
+### AI Integration
+
+- [ ] MCP support
+- [ ] IDE integration
+- [ ] Agent integration
+
+---
+
+## SUCCESS_CRITERIA
+
+- [ ] Framework specifications are reusable
+- [ ] Extension specifications are composable
+- [ ] framework.md can be generated automatically
+- [ ] AI implementation consistency improves
+- [ ] AI architectural drift decreases
+- [ ] AI guesswork is minimized