# Docs

This folder contains the project documentation used to guide product, implementation, architecture, and agentic development work.

## Start Here

- [AGENTIC_WORKFLOW.md](/home/jbourdon/repos/social-media/docs/AGENTIC_WORKFLOW.md): human + agent development loop.
- [ARCHITECTURE.md](/home/jbourdon/repos/social-media/docs/ARCHITECTURE.md): technical structure and module boundaries.
- [DEVELOPMENT_WORKFLOW.md](/home/jbourdon/repos/social-media/docs/DEVELOPMENT_WORKFLOW.md): local commands and validation.
- [PRODUCT.md](/home/jbourdon/repos/social-media/docs/PRODUCT.md): current product definition.
- [CONVENTIONS.md](/home/jbourdon/repos/social-media/docs/CONVENTIONS.md): implementation and documentation conventions.

## Agentic Scaffold

- [FEATURES/](/home/jbourdon/repos/social-media/docs/FEATURES): feature specs and product behavior.
- [TASKS/](/home/jbourdon/repos/social-media/docs/TASKS): small implementation tickets for agents.
- [PROMPTS/](/home/jbourdon/repos/social-media/docs/PROMPTS): reusable task prompts.
- [DECISIONS/](/home/jbourdon/repos/social-media/docs/DECISIONS): decision records.
- [FEATURE_TEMPLATE.md](/home/jbourdon/repos/social-media/docs/FEATURE_TEMPLATE.md): feature spec template.
- [TASK_TEMPLATE.md](/home/jbourdon/repos/social-media/docs/TASK_TEMPLATE.md): task template.
- [PROMPT_TEMPLATE.md](/home/jbourdon/repos/social-media/docs/PROMPT_TEMPLATE.md): general prompt template.

## Current Product Sources

- [product/vision.md](/home/jbourdon/repos/social-media/docs/product/vision.md): product intent, users, scope, and priorities.
- [product/glossary.md](/home/jbourdon/repos/social-media/docs/product/glossary.md): canonical domain vocabulary.
- [constraints.md](/home/jbourdon/repos/social-media/docs/constraints.md): business and technical invariants.
- [BACKLOG.md](/home/jbourdon/repos/social-media/docs/BACKLOG.md): deferred technical and product work.

## Archived

- [archive/PLAN.md](/home/jbourdon/repos/social-media/docs/archive/PLAN.md): early pivot plan.
- [archive/SOCIALIZE.md](/home/jbourdon/repos/social-media/docs/archive/SOCIALIZE.md): original consolidated product brief.
- [archive/Stripe.md](/home/jbourdon/repos/social-media/docs/archive/Stripe.md): legacy Hutopy monetization notes.
- [archive/WORKSHEET.md](/home/jbourdon/repos/social-media/docs/archive/WORKSHEET.md): historical transition worksheet.

## Root Docs

- [README.md](/home/jbourdon/repos/social-media/README.md): repository overview and local development setup.
- [AGENTS.md](/home/jbourdon/repos/social-media/AGENTS.md): working guide for coding agents.