91 lines
2.2 KiB
Markdown
91 lines
2.2 KiB
Markdown
# Repository Setup Verification
|
|
|
|
Verify this repository is configured correctly for AI agent workflows.
|
|
|
|
## Checklist
|
|
|
|
### 1. Environment (direnv)
|
|
|
|
**Check `.envrc` exists with:**
|
|
```bash
|
|
# 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):
|
|
```bash
|
|
echo $ANTHROPIC_API_KEY | head -c 10
|
|
echo $OPENAI_API_KEY | head -c 10
|
|
```
|
|
|
|
Should show first 10 chars (not empty).
|
|
|
|
## Actions
|
|
|
|
1. Report status of each item (✓ ok / ✗ missing / ⚠ partial)
|
|
2. Ask which skills configuration is appropriate if `.skills` is missing
|
|
3. Ask about beads setup if `.beads/` is missing
|
|
4. Fix any issues using the patterns above
|
|
5. Run `direnv reload` after any `.envrc` or `.skills` changes
|
|
6. Summarize what was checked and any changes made
|
|
|
|
## Reference
|
|
|
|
Full setup documentation: `~/proj/dotfiles/docs/new-repo-setup.md`
|
|
Available skills: `~/proj/skills/skills/`
|