Fix README links, add missing skills, correct invocation classification

- Fixed 3 broken links in root and common READMEs (pkm-curation,
  forge-interaction, forge-preferences were pointing to wrong buckets)
- Moved project-context-pack from model-invoked to user-invoked
  (matches its disable-model-invocation: true flag)
- Added 8 missing user-invoked and 6 missing model-invoked skills
  to root and common READMEs
- Added all 9 engineering skills to engineering README
  (was missing codebase-design, domain-modeling, resolving-merge-conflicts,
  tdd, grill-with-docs, improve-codebase-architecture, setup-skills,
  to-issues, to-prd, triage)
- Added pkm-curation to pkm README
- Updated personal README to note both skills moved elsewhere
- Added all forge skills to deprecated README
- Added .gitignore for docs/adr/
- Added docs/agents/ reference files
- Added project context cache

.agent/project-context.md

@@ -0,0 +1,103 @@
+# Project Context Pack
+
+Generated: 2026-06-25
+Root: /home/sjb/Documents/ai-workflows/skills
+Working directory: .
+Status: fresh
+
+## Purpose
+A collection of agent skills (slash commands and behaviors) loaded into Steve Beaulac's AI coding agents. Each skill is a SKILL.md file that teaches the agent how to handle a specific task — from codebase design and TDD to Obsidian PKM workflows and forge interaction.
+
+## Project type
+- **Agent skill repository** — markdown-defined agent instructions
+- Languages: Markdown (100%)
+- Package managers: none
+- Build/test tools: none
+- Agent guidance: `AGENTS.md` at root, `docs/invocation.md` for invocation conventions, `docs/agents/` for issue tracker / triage labels / ADR wiki / domain docs
+
+## Structure
+```
+.
+├── AGENTS.md                    # Top-level agent instructions for this repo
+├── README.md                    # Project overview, lists user-invoked and model-invoked skills
+├── .gitignore                   # Excludes docs/adr/
+├── docs/
+│   ├── invocation.md            # Model-invoked vs user-invoked definitions
+│   ├── agents/
+│   │   ├── adr-wiki.md          # ADR wiki setup docs
+│   │   ├── domain.md            # Domain docs layout
+│   │   ├── issue-tracker.md     # Gitea issue tracker docs
+│   │   └── triage-labels.md     # Five-label triage vocabulary
+│   └── adr/                     # ADR wiki clone (gitignored)
+└── common/
+    ├── README.md                # Lists all common skills by invocation type
+    ├── engineering/             # Model-invoked: forge-interaction, project-context-pack; also sub-skills for codebase-design, domain-modeling, tdd, triage, etc.
+    ├── productivity/            # User-invoked: grill-me, handoff, writing-great-skills; Model-invoked: grilling
+    ├── pkm/                     # User-invoked: conversation-summary, crit, knowledge-gardener, research-vault
+    ├── personal/                # User-invoked: pkm-curation; Model-invoked: forge-preferences
+    └── deprecated/              # Deprecated skills (audio-production-dispatcher, dsp-research-dispatcher, forge-*)
+```
+
+## Important files
+- `AGENTS.md` — Agent entry point that describes structure, categories, and references docs
+- `README.md` — Index of all skills divided into user-invoked and model-invoked (recently updated to fix broken links, add missing skills, correct invocation classification)
+- `docs/invocation.md` — Defines the invocation model (disable-model-invocation frontmatter key, human vs model reachability, dependency rules)
+- `docs/agents/` — Agent documentation for issue tracker, triage labels, ADR wiki, domain docs
+- `common/engineering/project-context-pack/SKILL.md` — The currently running skill
+- `common/engineering/codebase-design/SKILL.md` — Deep module design vocabulary (referenced by other skills)
+- `common/engineering/domain-modeling/SKILL.md` — Domain modeling with ADRs and CONTEXT files
+- `common/engineering/tdd/SKILL.md` — Test-driven development discipline
+- `common/productivity/grilling/SKILL.md` — Relentless plan/design interview (model-invoked, triggers)
+- `common/productivity/writing-great-skills/SKILL.md` — Reference for writing/editing skills
+
+## Commands
+- Build: none
+- Test: none
+- Lint/typecheck: none
+- Run/dev: skills are invoked by AI agents — no server or dev command
+
+## Entry points
+- `AGENTS.md` — loaded by the AI agent as project instructions (referred to in pi's agent config)
+- Each `SKILL.md` under `common/` — referenced by agents via slash commands or auto-invocation
+
+## Search and symbol notes
+- All skills are `SKILL.md` files — search with `fd SKILL.md`
+- Bucket READMEs: `fd README.md common/`
+- Skills are classified as **user-invoked** (`disable-model-invocation: true` in frontmatter) or **model-invoked** (default, no frontmatter flag)
+- Dependencies between skills use prose invocation ("Run the `/grilling` skill"), not file cross-references
+- Shared reference docs live inside the owning skill's directory; other skills reach that material by invoking the skill
+
+## Files inspected
+- `AGENTS.md` — root agent instructions — fresh
+- `README.md` — project overview — updated (all links fixed, missing skills added, invocation corrected)
+- `docs/invocation.md` — invocation model definitions — fresh
+- `.gitignore` — excludes docs/adr/ — fresh
+- `common/engineering/README.md` — engineering bucket index — updated (all engineering skills added, misclassified skills corrected)
+- `common/README.md` — common bucket index — updated (links fixed, missing skills added)
+- `common/productivity/README.md` — productivity bucket index — fresh (was already correct)
+- `common/pkm/README.md` — pkm bucket index — updated (pkm-curation added)
+- `common/personal/README.md` — personal bucket index — updated (noted both skills moved elsewhere)
+- `common/deprecated/README.md` — deprecated bucket index — updated (all forge skills added)
+- All `SKILL.md` files — frontmatter checked for invocation status
+
+## Exclusions
+- `.git/` — VCS data
+- `docs/adr/` — gitignored ADR wiki clone
+- `node_modules/`, `dist/`, `build/`, `target/`, `.venv/`, `__pycache__/`, `vendor/`, `coverage/` — not present, but excluded by policy
+- Binary files, large artifacts, credentials, secrets, personal data
+
+## Navigation rules for future agents
+- Start with `fd SKILL.md` to find all skills, then narrow by `fd SKILL.md common/<category>/`
+- To understand a skill's purpose, read its `SKILL.md` and the bucket `README.md` that indexes it
+- For invocation rules (user-invoked vs model-invoked), read `docs/invocation.md`
+- For agent-level docs (issue tracker, triage, ADR, domain), check `docs/agents/`
+- Do not browse directories file-by-file; use `fd` and `rg` first
+- Track every inspected file in this cache
+- Re-read a file only when it changed, the cache is stale, or exact details are needed
+
+## Refresh notes
+- This is a markdown-only repo with no build artifacts; refreshes are rarely needed unless skills are added or removed
+- To refresh, re-run `tree -a -I '.git' -L 4` and re-read any changed bucket READMEs or SKILL.md files
+- The `docs/adr/` directory is gitignored — if ADR data is needed, check the Gitea wiki directly
+- All README.md files were updated on 2026-06-25 to fix broken links, add missing skills, and correct invocation classification
+- If a skill is moved between buckets, update all README.md files that reference it (root, common, source bucket, destination bucket)