Jay Dev Init

Initialize the jay-dev documentation system for this project.

jayhjenkins updated 6mo ago
Claude CodeGeneric
View source ↗
# Jay-Dev Init Command

Initialize the jay-dev documentation system for this project.

## What This Command Does

1. **Checks for existing docs** - Verifies if documentation structure already exists
2. **Creates missing documentation** - Bootstraps any missing docs from templates
3. **Initializes loop state** - Sets up Ralph loop state tracking
4. **Reports status** - Shows what was created and next steps

## Expected Behavior

### If Already Initialized

If docs already exist, report current status:

✅ Jay-Dev already initialized

Existing docs:

  • docs/PRD.md (last updated: 2026-01-03)
  • docs/ARCHITECTURE.md (last updated: 2026-01-03)
  • docs/status/STATUS.md (current goal: [from file])
  • docs/qa/TEST_INDEX.md

Run /jay-dev:write-plan to create an implementation plan.


### If Not Initialized

Create documentation structure:

1. **Create docs/PRD.md** - From template with placeholders
2. **Create docs/ARCHITECTURE.md** - From template with placeholders
3. **Create docs/ADR/0001-template.md** - ADR template for future decisions
4. **Create docs/status/STATUS.md** - Initial status (fresh start)
5. **Create docs/plans/README.md** - Explanation of plan storage
6. **Create docs/qa/TEST_INDEX.md** - Empty test inventory
7. **Create docs/qa/RUNS/README.md** - Explanation of test run storage
8. **Initialize docs/status/.loop_state.json** - Ralph loop state

Then report:

✅ Jay-Dev initialized successfully

Created documentation:

  • docs/PRD.md - Define your product requirements here
  • docs/ARCHITECTURE.md - Document your system design here
  • docs/ADR/0001-template.md - Use this for architecture decisions
  • docs/status/STATUS.md - Current status tracking
  • docs/qa/TEST_INDEX.md - Test inventory

Next steps:

  1. Edit docs/PRD.md with your project's requirements
  2. Edit docs/ARCHITECTURE.md with initial architecture (or leave blank if greenfield)
  3. Run /jay-dev:write-plan to create an implementation plan

Ralph loop active: Stop hook will prevent exit until work is complete (check STATUS.md)


## Implementation

Execute the following:

```bash
# Check if already initialized
if [[ -f docs/status/STATUS.md ]] && [[ -f docs/PRD.md ]] && [[ -f docs/ARCHITECTURE.md ]]; then
  echo "Already initialized - report status"
else
  echo "Not initialized - create docs from templates"
fi

Then create each missing document using the templates defined in this system.

Verification

After creating docs, verify:

  • All files created successfully
  • Files contain template content (not empty)
  • Loop state initialized
  • Vendor directories exist (vendor/superpowers, vendor/ralph-wiggum)

Error Handling

If creation fails:

  • Report which files failed to create
  • Suggest manual creation with template content
  • Do not mark as initialized if incomplete

Maintain Jay Dev Init?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[Jay Dev Init on getagentictools](https://getagentictools.com/loops/jayhjenkins-jay-dev-init-command?ref=badge)
npx agentictools info loops/jayhjenkins-jay-dev-init-command

The second line is the CLI lookup for this page — handy in READMEs and docs.