# Seth-Workflow-April-2026

This repository contains a shareable AI-assisted development workflow. It is a reference and template — not an active project with running services.

## What This Is

A two-tier workflow system for AI coding assistants (Claude Code, etc.), reflecting how the workflow is actually used across 26+ projects.

## Two Tiers

### Core (every project)
The `core/` directory describes the practices that run universally:
- **Document hierarchy** — CLAUDE.md / SESSION.md / CONTEXT.md / IDEA.md
- **Superpowers plugin** — The workflow engine (brainstorming, TDD, debugging, verification)
- **Memory system** — Persistent feedback and project memories across sessions
- **Backup before edit** — .backup/ directory before any modification
- **Commit & push** — Every change, immediately, conventional commits
- **Feedback behaviors** — Learned corrections and confirmed approaches

### Advanced (complex projects only)
The `rules/` directory contains `.claude/rules/` files for projects that need explicit governance beyond what the core provides.

## Structure

| Directory | Purpose |
|-----------|---------|
| `core/` | Universal practices (every project) |
| `rules/` | Advanced governance rules (copy to `.claude/rules/`) |
| `templates/` | File templates for bootstrapping new projects |
| `hooks/` | Claude Code hooks (pre-push secret scanning) |
| `settings/` | Example Claude Code configuration |
| `workflows/` | Human-readable methodology guides |
| `docs/` | Philosophy and customization documentation |

## Conventions

- Conventional commits: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`
- All files are self-contained markdown with no external dependencies
- Templates use `<placeholder>` syntax for values the user fills in
- No credentials, IPs, or personal information anywhere in this repo