@mindfoldhq/trellis 0.1.0

package/dist/templates/markdown/agent-traces-index.md.txt

@@ -0,0 +1,124 @@
+# Agent Progress Index
+
+> Records of all AI Agent work sessions across all developers
+
+---
+
+## Overview
+
+This directory tracks progress for all developers working with AI Agents on this project.
+
+### File Structure
+
+```
+agent-traces/
+|-- index.md              # This file - main index
+\-- {developer}/          # Per-developer directory
+    |-- index.md          # Personal index with session history
+    |-- features/         # Feature files
+    |   |-- *.json        # Active features
+    |   \-- archive/      # Archived features by month
+    \-- progress-N.md     # Progress files (sequential: 1, 2, 3...)
+```
+
+---
+
+## Active Developers
+
+| Developer | Last Active | Sessions | Active File |
+|-----------|-------------|----------|-------------|
+| (none yet) | - | - | - |
+
+---
+
+## Getting Started
+
+### For New Developers
+
+Run the initialization script:
+
+```bash
+./.trellis/scripts/init-developer.sh <your-name>
+```
+
+This will:
+1. Create your identity file (gitignored)
+2. Create your progress directory
+3. Create your personal index
+4. Create initial progress file
+
+### For Returning Developers
+
+1. Get your developer name:
+   ```bash
+   ./.trellis/scripts/get-developer.sh
+   ```
+
+2. Read your personal index:
+   ```bash
+   cat .trellis/agent-traces/$(./.trellis/scripts/get-developer.sh)/index.md
+   ```
+
+---
+
+## Guidelines
+
+### Progress File Rules
+
+- **Max 2000 lines** per progress file
+- When limit is reached, create `progress-{N+1}.md`
+- Update your personal `index.md` when creating new files
+
+### Session Record Format
+
+Each session should include:
+- Summary: One-line description
+- Main Changes: What was modified
+- Git Commits: Commit hashes and messages
+- Next Steps: What to do next
+
+---
+
+## Session Template
+
+Use this template when recording sessions:
+
+```markdown
+## Session {N}: {Title}
+
+**Date**: YYYY-MM-DD
+**Feature**: {feature-name}
+
+### Summary
+
+{One-line summary}
+
+### Main Changes
+
+- {Change 1}
+- {Change 2}
+
+### Git Commits
+
+| Hash | Message |
+|------|---------|
+| `abc1234` | {commit message} |
+
+### Testing
+
+- [OK] {Test result}
+
+### Status
+
+[OK] **Completed** / # **In Progress** / [P] **Blocked**
+
+### Next Steps
+
+- {Next step 1}
+- {Next step 2}
+```
+
+---
+
+**Language**: All documentation must be written in **English**.
+

package/dist/templates/markdown/agents.md.txt

@@ -0,0 +1,18 @@
+<!-- TRELLIS:START -->
+# Trellis Instructions
+
+These instructions are for AI assistants working in this project.
+
+Use the `/start` command when starting a new session to:
+- Initialize your developer identity
+- Understand current project context
+- Read relevant guidelines
+
+Use `@/.trellis/` to learn:
+- Development workflow (`workflow.md`)
+- Project structure guidelines (`structure/`)
+- Progress tracking (`agent-traces/`)
+
+Keep this managed block so 'trellis update' can refresh the instructions.
+
+<!-- TRELLIS:END -->

package/dist/templates/markdown/gitignore.txt

@@ -0,0 +1,3 @@
+# Developer identity (local only)
+.developer
+

package/dist/templates/markdown/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Markdown templates for Trellis workflow
+ * Each template is stored as a .txt file
+ */
+export declare const agentProgressIndexContent: string;
+export declare const workflowMdContent: string;
+export declare const workflowGitignoreContent: string;
+export declare const initAgentContent: string;
+export declare const agentsMdContent: string;
+export declare const backendIndexContent: string;
+export declare const backendDirectoryStructureContent: string;
+export declare const backendDatabaseGuidelinesContent: string;
+export declare const backendLoggingGuidelinesContent: string;
+export declare const backendQualityGuidelinesContent: string;
+export declare const backendErrorHandlingContent: string;
+export declare const frontendIndexContent: string;
+export declare const frontendDirectoryStructureContent: string;
+export declare const frontendTypeSafetyContent: string;
+export declare const frontendHookGuidelinesContent: string;
+export declare const frontendComponentGuidelinesContent: string;
+export declare const frontendQualityGuidelinesContent: string;
+export declare const frontendStateManagementContent: string;
+export declare const guidesIndexContent: string;
+export declare const guidesCrossLayerThinkingGuideContent: string;
+export declare const guidesCodeReuseThinkingGuideContent: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/markdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,MAAwC,CAAC;AACzE,eAAO,MAAM,wBAAwB,EAAE,MAAsC,CAAC;AAG9E,eAAO,MAAM,gBAAgB,EAAE,MAA0C,CAAC;AAC1E,eAAO,MAAM,eAAe,EAAE,MAAsC,CAAC;AAGrE,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAElC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AACF,eAAO,MAAM,6BAA6B,EAAE,MAE3C,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAE5C,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC"}

package/dist/templates/markdown/index.js

@@ -0,0 +1,33 @@
+/**
+ * Markdown templates for Trellis workflow
+ * Each template is stored as a .txt file
+ */
+import { readMarkdown } from "../extract.js";
+// Agent progress
+export const agentProgressIndexContent = readMarkdown("agent-traces-index.md.txt");
+// Workflow documentation
+export const workflowMdContent = readMarkdown("workflow.md.txt");
+export const workflowGitignoreContent = readMarkdown("gitignore.txt");
+// Root files
+export const initAgentContent = readMarkdown("init-agent.md.txt");
+export const agentsMdContent = readMarkdown("agents.md.txt");
+// Backend structure (multi-doc format)
+export const backendIndexContent = readMarkdown("structure/backend/index.md.txt");
+export const backendDirectoryStructureContent = readMarkdown("structure/backend/directory-structure.md.txt");
+export const backendDatabaseGuidelinesContent = readMarkdown("structure/backend/database-guidelines.md.txt");
+export const backendLoggingGuidelinesContent = readMarkdown("structure/backend/logging-guidelines.md.txt");
+export const backendQualityGuidelinesContent = readMarkdown("structure/backend/quality-guidelines.md.txt");
+export const backendErrorHandlingContent = readMarkdown("structure/backend/error-handling.md.txt");
+// Frontend structure (multi-doc format)
+export const frontendIndexContent = readMarkdown("structure/frontend/index.md.txt");
+export const frontendDirectoryStructureContent = readMarkdown("structure/frontend/directory-structure.md.txt");
+export const frontendTypeSafetyContent = readMarkdown("structure/frontend/type-safety.md.txt");
+export const frontendHookGuidelinesContent = readMarkdown("structure/frontend/hook-guidelines.md.txt");
+export const frontendComponentGuidelinesContent = readMarkdown("structure/frontend/component-guidelines.md.txt");
+export const frontendQualityGuidelinesContent = readMarkdown("structure/frontend/quality-guidelines.md.txt");
+export const frontendStateManagementContent = readMarkdown("structure/frontend/state-management.md.txt");
+// Guides structure
+export const guidesIndexContent = readMarkdown("structure/guides/index.md.txt");
+export const guidesCrossLayerThinkingGuideContent = readMarkdown("structure/guides/cross-layer-thinking-guide.md.txt");
+export const guidesCodeReuseThinkingGuideContent = readMarkdown("structure/guides/code-reuse-thinking-guide.md.txt");
+//# sourceMappingURL=index.js.map

package/dist/templates/markdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,iBAAiB;AACjB,MAAM,CAAC,MAAM,yBAAyB,GAAW,YAAY,CAC3D,2BAA2B,CAC5B,CAAC;AAEF,yBAAyB;AACzB,MAAM,CAAC,MAAM,iBAAiB,GAAW,YAAY,CAAC,iBAAiB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAW,YAAY,CAAC,eAAe,CAAC,CAAC;AAE9E,aAAa;AACb,MAAM,CAAC,MAAM,gBAAgB,GAAW,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAW,YAAY,CAAC,eAAe,CAAC,CAAC;AAErE,uCAAuC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAW,YAAY,CACrD,gCAAgC,CACjC,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAW,YAAY,CAClE,8CAA8C,CAC/C,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAW,YAAY,CAClE,8CAA8C,CAC/C,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAW,YAAY,CACjE,6CAA6C,CAC9C,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAW,YAAY,CACjE,6CAA6C,CAC9C,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAW,YAAY,CAC7D,yCAAyC,CAC1C,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAW,YAAY,CACtD,iCAAiC,CAClC,CAAC;AACF,MAAM,CAAC,MAAM,iCAAiC,GAAW,YAAY,CACnE,+CAA+C,CAChD,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAW,YAAY,CAC3D,uCAAuC,CACxC,CAAC;AACF,MAAM,CAAC,MAAM,6BAA6B,GAAW,YAAY,CAC/D,2CAA2C,CAC5C,CAAC;AACF,MAAM,CAAC,MAAM,kCAAkC,GAAW,YAAY,CACpE,gDAAgD,CACjD,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAW,YAAY,CAClE,8CAA8C,CAC/C,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAW,YAAY,CAChE,4CAA4C,CAC7C,CAAC;AAEF,mBAAmB;AACnB,MAAM,CAAC,MAAM,kBAAkB,GAAW,YAAY,CACpD,+BAA+B,CAChC,CAAC;AACF,MAAM,CAAC,MAAM,oCAAoC,GAAW,YAAY,CACtE,oDAAoD,CACrD,CAAC;AACF,MAAM,CAAC,MAAM,mCAAmC,GAAW,YAAY,CACrE,mDAAmD,CACpD,CAAC"}

package/dist/templates/markdown/init-agent.md.txt

@@ -0,0 +1,315 @@
+# AI Agent Initialization Guide
+
+> **Purpose**: Quick onboarding document for new AI Agent sessions. Read this first to understand the project and workflow.
+
+---
+
+## Quick Start (Do This First)
+
+### Step 0: Initialize Developer Identity (First Time Only)
+
+> **Multi-developer support**: Each developer/Agent needs to initialize their identity first
+
+```bash
+# Check if already initialized
+./.trellis/scripts/get-developer.sh
+
+# If not initialized, run:
+./.trellis/scripts/init-developer.sh <your-name>
+# Example: ./.trellis/scripts/init-developer.sh cursor-agent
+```
+
+This creates:
+- `.trellis/.developer` - Your identity file (gitignored, not committed)
+- `.trellis/agent-traces/<your-name>/` - Your personal progress directory
+
+**Naming suggestions**:
+- Human developers: Use your name, e.g., `john-doe`
+- Cursor AI: `cursor-agent` or `cursor-<feature>`
+- Claude Code: `claude-agent` or `claude-<feature>`
+
+### Step 1: Understand Current Context (5 min)
+
+```bash
+# Get full context in one command
+./.trellis/scripts/get-context.sh
+
+# Or check manually:
+./.trellis/scripts/get-developer.sh      # Your identity
+./.trellis/scripts/feature.sh list       # Active features
+git status && git log --oneline -10      # Git state
+```
+
+### Step 2: Read Project Guidelines (10 min) [MANDATORY]
+
+**CRITICAL**: Read BOTH frontend and backend guideline indexes to understand the project:
+
+```bash
+# Read frontend guidelines index (REQUIRED - even for backend tasks)
+cat .trellis/structure/frontend/index.md
+
+# Read backend guidelines index (REQUIRED - even for frontend tasks)
+cat .trellis/structure/backend/index.md
+```
+
+**Why read both?**
+- Understand the full project architecture
+- Know coding standards for the entire codebase
+- See how frontend and backend interact
+- Learn the overall code quality requirements
+
+### Step 3: Read Workflow Guide (5 min)
+
+```bash
+cat .trellis/workflow.md
+```
+
+**CRITICAL**: This document defines the entire development workflow. You MUST follow it.
+
+### Step 4: Before Coding - Read Specific Guidelines (Required)
+
+Based on your task, read the **detailed** guidelines:
+
+**Frontend Task**:
+```bash
+cat .trellis/structure/frontend/hook-guidelines.md      # For hooks
+cat .trellis/structure/frontend/component-guidelines.md # For components
+cat .trellis/structure/frontend/type-safety.md          # For types
+```
+
+**Backend Task**:
+```bash
+cat .trellis/structure/backend/database-guidelines.md   # For DB operations
+cat .trellis/structure/backend/type-safety.md           # For Zod/types
+cat .trellis/structure/backend/logging-guidelines.md    # For logging
+```
+
+---
+
+## Project Overview
+
+### What is This Project?
+
+[Fill in your project description here after running `trellis init`]
+
+### Tech Stack
+
+[Fill in your tech stack here]
+
+### Key Information
+
+- **Main Branch**: Check with `git branch`
+- **Current Branch**: Check `git status`
+- **Package Manager**: Check for package-lock.json (npm), yarn.lock (yarn), or pnpm-lock.yaml (pnpm)
+- **Linter**: Check package.json scripts
+
+---
+
+## Directory Structure
+
+```
+your-project/
+├── .trellis/                 # [!] Agent-Human collaboration system
+│   ├── workflow.md              # Workflow guide (MUST READ)
+│   ├── scripts/             # Workflow scripts
+│   │   ├── common/          # Shared utilities
+│   │   ├── feature.sh       # Feature management
+│   │   ├── get-context.sh   # Get session context
+│   │   └── add-session.sh   # Record session
+│   ├── agent-traces/      # Work progress records
+│   │   └── {developer}/     # Per-developer directories
+│   │       ├── features/    # Feature directories
+│   │       │   └── {day}-{name}/
+│   │       │       └── feature.json
+│   │       └── progress-N.md
+│   ├── structure/           # [!] Development guidelines (MUST READ)
+│   │   ├── frontend/
+│   │   │   ├── index.md     # Frontend guidelines index
+│   │   │   └── *.md         # Topic-specific docs
+│   │   ├── backend/
+│   │   │   ├── index.md     # Backend guidelines index
+│   │   │   └── *.md         # Topic-specific docs
+│   │   └── guides/          # Thinking guides
+├── init-agent.md            # This initialization guide
+└── AGENTS.md                # Compatible with agents.md protocol
+```
+
+---
+
+## Development Workflow System
+
+### Overview
+
+This project uses a structured workflow system based on [Anthropic's best practices](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents).
+
+### Core Files
+
+| File | Purpose | When to Update |
+|------|---------|----------------|
+| `.trellis/workflow.md` | Complete workflow guide | Read at session start |
+| `.trellis/agent-traces/{developer}/features/` | Feature tracking | When creating/completing features |
+| `.trellis/agent-traces/{developer}/progress-N.md` | Session work records | After each session |
+
+### Key Rules (CRITICAL - Must Follow)
+
+**1. Read Guidelines Before Coding**
+   - Frontend: `.trellis/structure/frontend/index.md` -> specific docs
+   - Backend: `.trellis/structure/backend/index.md` -> specific docs
+   - This is **mandatory**, not optional
+
+**2. Document Limits** **CRITICAL RULE**
+   - `agent-traces/{developer}/progress-N.md` max 2000 lines
+   - **IMPORTANT: Only create new file when current file EXCEEDS 2000 lines**
+   - File naming: Use sequential numbers (`progress-1.md`, `progress-2.md`...)
+
+**3. Update Tracking Files**
+   - After completing work: Update `agent-traces` (include commit hashes)
+   - When feature changes: Use `feature.sh` commands
+
+---
+
+## How to Use the Workflow System
+
+### At Session Start
+
+1. **Get context** - Run `./.trellis/scripts/get-context.sh`
+2. **Read ALL guideline indexes** (see Quick Start Step 2 above)
+   - **MANDATORY**: Read both frontend AND backend indexes
+3. **Read workflow guide** - `cat .trellis/workflow.md`
+4. **Identify your task** from feature list
+5. **Read specific guidelines** for your task
+6. **Create or select feature** to work on
+
+### During Development
+
+1. **Create feature** (if new)
+   ```bash
+   ./.trellis/scripts/feature.sh create <feature-name>
+   ```
+
+2. **Follow guidelines strictly**
+   - Frontend: Type safety, Hook standards, Component standards
+   - Backend: Directory structure, Type safety, Database operations
+
+3. **Test before commit**
+   ```bash
+   npm run lint        # or pnpm lint / yarn lint - Must pass
+   npm run type-check  # or pnpm type-check - Must pass
+   ```
+
+4. **Commit with convention**
+   ```bash
+   git commit -m "type(scope): description"
+   # Types: feat, fix, docs, refactor, test, chore
+   ```
+
+### At Session End (REQUIRED)
+
+**Record your session**:
+```bash
+./.trellis/scripts/add-session.sh \
+  --title "Session Title" \
+  --commit "abc1234" \
+  --summary "Brief summary"
+```
+
+This automatically:
+- Appends session to current progress file
+- Creates new file if 2000-line limit exceeded
+- Updates index.md
+
+**Archive completed feature**:
+```bash
+./.trellis/scripts/feature.sh archive <feature-name>
+```
+
+---
+
+## Common Commands
+
+### Workflow Scripts
+```bash
+./.trellis/scripts/get-context.sh           # Get full context
+./.trellis/scripts/get-developer.sh         # Get current developer
+./.trellis/scripts/init-developer.sh <name> # Initialize developer
+./.trellis/scripts/feature.sh list          # List features
+./.trellis/scripts/feature.sh create <name> # Create feature
+./.trellis/scripts/feature.sh archive <name># Archive feature
+./.trellis/scripts/add-session.sh           # Record session
+```
+
+### Development
+```bash
+npm run dev           # Start dev server
+npm run build         # Production build
+npm run lint          # Run linter
+npm run format        # Format code
+npm run type-check    # Type checking
+```
+
+### Git
+```bash
+git status
+git log --oneline -20
+git diff main...HEAD
+```
+
+---
+
+## Critical Reminders
+
+### DO (Follow These)
+
+1. **Read BOTH guideline indexes** at session start (frontend AND backend)
+2. **Read .trellis/workflow.md** at session start
+3. **Read specific docs** before coding (based on task)
+4. **Update tracking files** after work
+5. **Test thoroughly** before committing
+6. **Follow guidelines strictly**
+
+### DON'T (Avoid These)
+
+1. **Don't skip reading guideline indexes** at initialization (CRITICAL VIOLATION)
+2. **Don't skip reading specific guidelines** before coding
+3. **Don't exceed 2000 lines** in agent-traces files
+4. **Don't commit with lint errors**
+5. **Don't use non-null assertions** (`!`)
+6. **Don't skip updating tracking files**
+7. **Don't execute `git commit`** - AI should not commit code (only suggest)
+
+---
+
+## Your First Task Checklist
+
+### Before You Start Coding
+
+- [ ] Run `./.trellis/scripts/get-context.sh` - Understand context
+- [ ] Read `.trellis/workflow.md` - Understand the workflow
+- [ ] Read `.trellis/structure/[frontend|backend]/index.md` - Find relevant guidelines
+- [ ] Read specific guideline docs based on your task
+- [ ] Create or select a feature with `feature.sh`
+- [ ] Start coding following the guidelines
+
+### After Completing Your Work
+
+- [ ] Run lint and type-check - Must pass
+- [ ] Commit with proper message format
+- [ ] Run `add-session.sh` to record progress
+- [ ] Archive feature if completed with `feature.sh archive`
+
+---
+
+## Success Criteria
+
+You're doing well if:
+
+- [x] All lint and type checks pass
+- [x] Code follows the guidelines
+- [x] Session is recorded via `add-session.sh`
+- [x] Features are tracked via `feature.sh`
+- [x] Commits are well-formatted
+- [x] Documentation is up-to-date
+
+---
+
+**Ready to start? Follow the Quick Start section at the top!**

package/dist/templates/markdown/structure/backend/database-guidelines.md.txt

@@ -0,0 +1,51 @@
+# Database Guidelines
+
+> Database patterns and conventions for this project.
+
+---
+
+## Overview
+
+<!--
+Document your project's database conventions here.
+
+Questions to answer:
+- What ORM/query library do you use?
+- How are migrations managed?
+- What are the naming conventions for tables/columns?
+- How do you handle transactions?
+-->
+
+(To be filled by the team)
+
+---
+
+## Query Patterns
+
+<!-- How should queries be written? Batch operations? -->
+
+(To be filled by the team)
+
+---
+
+## Migrations
+
+<!-- How to create and run migrations -->
+
+(To be filled by the team)
+
+---
+
+## Naming Conventions
+
+<!-- Table names, column names, index names -->
+
+(To be filled by the team)
+
+---
+
+## Common Mistakes
+
+<!-- Database-related mistakes your team has made -->
+
+(To be filled by the team)

package/dist/templates/markdown/structure/backend/directory-structure.md.txt

@@ -0,0 +1,54 @@
+# Directory Structure
+
+> How backend code is organized in this project.
+
+---
+
+## Overview
+
+<!--
+Document your project's backend directory structure here.
+
+Questions to answer:
+- Where do API routes/handlers live?
+- Where does business logic go?
+- How are database-related files organized?
+- Where are shared utilities?
+-->
+
+(To be filled by the team)
+
+---
+
+## Directory Layout
+
+```
+<!-- Replace with your actual structure -->
+server/
+├── ...
+└── ...
+```
+
+---
+
+## Module Organization
+
+<!-- How should new features be organized? -->
+
+(To be filled by the team)
+
+---
+
+## Naming Conventions
+
+<!-- File and folder naming rules -->
+
+(To be filled by the team)
+
+---
+
+## Examples
+
+<!-- Link to well-organized modules as examples -->
+
+(To be filled by the team)

package/dist/templates/markdown/structure/backend/error-handling.md.txt

@@ -0,0 +1,51 @@
+# Error Handling
+
+> How errors are handled in this project's backend.
+
+---
+
+## Overview
+
+<!--
+Document your project's error handling conventions here.
+
+Questions to answer:
+- What error types do you use?
+- How are errors logged?
+- How are errors returned to clients?
+- How do you handle unexpected errors?
+-->
+
+(To be filled by the team)
+
+---
+
+## Error Types
+
+<!-- Custom error classes, error codes -->
+
+(To be filled by the team)
+
+---
+
+## Error Response Format
+
+<!-- How errors are formatted in API responses -->
+
+(To be filled by the team)
+
+---
+
+## Logging Errors
+
+<!-- How and where errors should be logged -->
+
+(To be filled by the team)
+
+---
+
+## Common Mistakes
+
+<!-- Error handling mistakes your team has made -->
+
+(To be filled by the team)