Repository Setup Verification

Verify this repository is configured correctly for AI agent workflows.

Checklist

1. Environment (direnv)

Check .envrc exists with:

# API keys from sops
use_api_keys

# AI Agent Skills
if [[ -f .skills ]]; then
  source ~/proj/skills/bin/use-skills.sh
  load_skills_from_manifest
fi

Verify: direnv status shows allowed, no errors on shell entry.

2. Skills Manifest

Check .skills exists. Choose skills based on project needs:

Skill	Purpose	When to Use
`worklog`	Create org-mode worklogs in `docs/worklogs/`	Most projects - documents work sessions
`orch`	Multi-model consensus/analysis via external AIs	Research, architecture decisions, second opinions
`niri-window-capture`	Screenshot any window across workspaces	UI work, visual debugging, documentation
`update-claude`	Check/install Claude Code updates	Development machines

Common configurations:

Minimal (documentation only):

worklog

Standard (most projects):

worklog
orch

Full:

worklog
orch
niri-window-capture

Verify: .claude/skills/ contains symlinks that resolve correctly.

3. Beads Issue Tracking (Optional)

For repos that need local issue tracking:

Check .beads/ directory exists with:

config.json
Git hooks configured

If missing and desired: Run bd setup claude --project

Skip if: Using external issue tracker (GitHub Issues, Gitea, etc.) as primary.

4. API Keys

Verify keys are available (after direnv loads):

echo $ANTHROPIC_API_KEY | head -c 10
echo $OPENAI_API_KEY | head -c 10

Should show first 10 chars (not empty).

Actions

Report status of each item (✓ ok / ✗ missing / ⚠ partial)
Ask which skills configuration is appropriate if .skills is missing
Ask about beads setup if .beads/ is missing
Fix any issues using the patterns above
Run direnv reload after any .envrc or .skills changes
Summarize what was checked and any changes made

Reference

Full setup documentation: ~/proj/dotfiles/docs/new-repo-setup.md Available skills: ~/proj/skills/skills/

2.2 KiB Raw Blame History