init: scaffold Seth-Workflow-April-2026

User-agnostic, shareable AI-assisted development workflow distilled from 26+ real projects. Includes 9 composable rules, 4 project templates, pre-push secret scanning hook, 3 methodology guides, and customization docs. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-01 15:55:58 -04:00
commit 9ff8e915b8
22 changed files with 1917 additions and 0 deletions
@@ -0,0 +1,93 @@
+# Project Scaffold Workflow
+
+A repeatable recipe for bootstrapping a new project directory with AI-assisted development in mind.
+
+## Steps
+
+### 1. Create the directory
+
+```bash
+mkdir <project-name>
+cd <project-name>
+```
+
+### 2. Create the project brief
+
+Copy and fill in `templates/IDEA.md`:
+
+```bash
+cp /path/to/Seth-Workflow-April-2026/templates/IDEA.md ./IDEA.md
+```
+
+Edit `IDEA.md` with:
+- What the project does (plain language)
+- What problem it solves
+- Known constraints or preferences
+
+This is the starting point an AI agent reads before any code exists. Keep it honest and rough.
+
+### 3. Create AI session memory
+
+```bash
+cp /path/to/Seth-Workflow-April-2026/templates/SESSION.md ./SESSION.md
+```
+
+Fill in the project summary and context file pointers. The session notes section grows over time as the AI accumulates decisions and discoveries.
+
+### 4. Create project instructions
+
+```bash
+cp /path/to/Seth-Workflow-April-2026/templates/CLAUDE.md ./CLAUDE.md
+```
+
+Fill in project state, architecture, key files, and conventions. This is loaded at the start of every AI session.
+
+### 5. Create infrastructure context (if applicable)
+
+```bash
+cp /path/to/Seth-Workflow-April-2026/templates/CONTEXT.md ./CONTEXT.md
+```
+
+Fill in deployment details, dependencies, and configuration. This is for static facts about where and how the project runs.
+
+### 6. Install rules
+
+```bash
+mkdir -p .claude/rules
+cp /path/to/Seth-Workflow-April-2026/rules/*.md .claude/rules/
+```
+
+These are auto-loaded by Claude Code at session start.
+
+### 7. Init git and push
+
+```bash
+git init
+echo ".env" >> .gitignore
+echo ".env.*" >> .gitignore
+echo "!.env.example" >> .gitignore
+git add -A
+git commit -m "init: scaffold project"
+git remote add origin <your-git-url>
+git push -u origin main
+```
+
+## Result
+
+A new project directory should contain:
+
+| File | Type | Purpose |
+|------|------|---------|
+| `IDEA.md` | file | Plain-language project brief |
+| `SESSION.md` | file | AI session memory (grows over time) |
+| `CLAUDE.md` | file | Project instructions for AI assistant |
+| `CONTEXT.md` | file | Static infrastructure facts |
+| `.claude/rules/*.md` | directory | Auto-loaded behavior rules |
+| `.gitignore` | file | Excludes secrets and env files |
+
+## Maintenance
+
+- **CLAUDE.md**: Update when components, tools, or architecture change
+- **SESSION.md**: Append after each session with decisions and discoveries
+- **CONTEXT.md**: Update when infrastructure changes
+- **IDEA.md**: Rarely changes after initial creation (it's a snapshot of the original intent)