5-phase-workflow 1.0.0

package/src/templates/INTEGRATIONS.md

@@ -0,0 +1,65 @@
+# External Integrations
+
+**Analysis Date:** {YYYY-MM-DD}
+
+## APIs & External Services
+
+**{Category}:**
+- {Service} - {What it's used for}
+    - SDK/Client: {package}
+    - Auth: {env var name}
+
+## Data Storage
+
+**Databases:**
+- {Type/Provider}
+    - Connection: {env var}
+    - Client: {ORM/client}
+
+**File Storage:**
+- {Service or "Local filesystem only"}
+
+**Caching:**
+- {Service or "None"}
+
+## Authentication & Identity
+
+**Auth Provider:**
+- {Service or "Custom"}
+    - Implementation: {approach}
+
+## Monitoring & Observability
+
+**Error Tracking:**
+- {Service or "None"}
+
+**Logs:**
+- {Approach}
+
+## CI/CD & Deployment
+
+**Hosting:**
+- {Platform}
+
+**CI Pipeline:**
+- {Service or "None"}
+
+## Environment Configuration
+
+**Required env vars:**
+- {List critical vars}
+
+**Secrets location:**
+- {Where secrets are stored}
+
+## Webhooks & Callbacks
+
+**Incoming:**
+- {Endpoints or "None"}
+
+**Outgoing:**
+- {Endpoints or "None"}
+
+---
+
+*Integration audit: {date}*

package/src/templates/STACK.md

@@ -0,0 +1,60 @@
+# Technology Stack
+
+**Analysis Date:** {YYYY-MM-DD}
+
+## Languages
+
+**Primary:**
+- {Language} {Version} - {Where used}
+
+**Secondary:**
+- {Language} {Version} - {Where used}
+
+## Runtime
+
+**Environment:**
+- {Runtime} {Version}
+
+**Package Manager:**
+- {Manager} {Version}
+- Lockfile: {present/missing}
+
+## Frameworks
+
+**Core:**
+- {Framework} {Version} - {Purpose}
+
+**Testing:**
+- {Framework} {Version} - {Purpose}
+
+**Build/Dev:**
+- {Tool} {Version} - {Purpose}
+
+## Key Dependencies
+
+**Critical:**
+- {Package} {Version} - {Why it matters}
+
+**Infrastructure:**
+- {Package} {Version} - {Purpose}
+
+## Configuration
+
+**Environment:**
+- {How configured}
+- {Key configs required}
+
+**Build:**
+- {Build config files}
+
+## Platform Requirements
+
+**Development:**
+- {Requirements}
+
+**Production:**
+- {Deployment target}
+
+---
+
+*Stack analysis: {date}*

package/src/templates/STRUCTURE.md

@@ -0,0 +1,60 @@
+# Codebase Structure
+
+**Analysis Date:** {YYYY-MM-DD}
+
+## Directory Layout
+
+{project-root} {dir} # {Purpose} / {dir} # {Purpose} / {file} # {Purpose}
+
+
+## Directory Purposes
+
+**{Directory Name}:**
+- Purpose: {What lives here}
+- Contains: {Types of files}
+- Key files: `{important files}`
+
+## Key File Locations
+
+**Entry Points:**
+- `{path}`: {Purpose}
+
+**Configuration:**
+- `{path}`: {Purpose}
+
+**Core Logic:**
+- `{path}`: {Purpose}
+
+**Testing:**
+- `{path}`: {Purpose}
+
+## Naming Conventions
+
+**Files:**
+- {Pattern}: {Example}
+
+**Directories:**
+- {Pattern}: {Example}
+
+## Where to Add New Code
+
+**New Feature:**
+- Primary code: `{path}`
+- Tests: `{path}`
+
+**New Component/Module:**
+- Implementation: `{path}`
+
+**Utilities:**
+- Shared helpers: `{path}`
+
+## Special Directories
+
+**{Directory}:**
+- Purpose: {What it contains}
+- Generated: {Yes/No}
+- Committed: {Yes/No}
+
+---
+
+*Structure analysis: {date}*

package/src/templates/TESTING.md

@@ -0,0 +1,107 @@
+# Testing Patterns
+
+**Analysis Date:** {YYYY-MM-DD}
+
+## Test Framework
+
+**Runner:**
+- {Framework} {Version}
+- Config: `{config file}`
+
+**Assertion Library:**
+- {Library}
+
+**Run Commands:**
+```bash
+{command}              # Run all tests
+{command}              # Watch mode
+{command}              # Coverage
+```
+
+## Test File Organization
+
+**Location:**
+
+    {Pattern: co-located or separate}
+
+**Naming:**
+
+    {Pattern}
+
+**Structure:**
+
+{Directory pattern}
+
+## Test Structure
+
+**Suite Organization:**
+
+{Show actual pattern from codebase}
+
+**Patterns:**
+
+- {Setup pattern}
+- {Teardown pattern}
+- {Assertion pattern}
+
+## Mocking
+
+**Framework:**
+- {Tool}
+
+**Patterns:**
+
+{Show actual mocking pattern from codebase}
+
+**What to Mock:**
+
+{Guidelines}
+
+**What NOT to Mock:**
+
+{Guidelines}
+
+## Fixtures and Factories
+
+**Test Data:**
+
+{Show pattern from codebase}
+
+**Location:**
+
+{Where fixtures live}
+
+## Coverage
+
+**Requirements:**
+- {Target or "None enforced"}
+
+**View Coverage:**
+
+```bash
+{command}
+```
+
+## Test Types
+
+**Unit Tests:**
+
+{Scope and approach}
+
+**Integration Tests:**
+
+{Scope and approach}
+
+**E2E Tests:**
+
+{Framework or "Not used"}
+
+## Common Patterns
+
+**Async Testing:**
+
+{Pattern}
+
+**Error Testing:**
+
+{Pattern}