d-oit · Nov 3, 2026 · Nov 3, 2026 · Nov 3, 2026 · Nov 3, 2026
diff --git a/.agents/instructions/claude.md b/.agents/instructions/claude.md
@@ -0,0 +1,42 @@
+## Claude Code Features
+
+### Sub-Agents
+Sub-agent definitions live in `.claude/agents/`. Each is a Markdown file with YAML
+frontmatter (`name`, `description`, `tools`, `model`).
+
+Default agents in this template:
+- `agent-creator` - scaffold new sub-agent definitions
+- `goap-agent` - goal-oriented action planning for complex workflows
+- `loop-agent` - iterative refinement loops
+- `analysis-swarm` - parallel multi-perspective code analysis
+
+Delegate context-heavy research to sub-agents to keep the parent session focused.
+See `agents-docs/SUB-AGENTS.md`.
+
+### Skills
+Skills live canonically in `.agents/skills/`. The `.claude/skills/` folder contains
+only symlinks. Run `./scripts/setup-skills.sh` once after cloning.
+
+Skills use progressive disclosure - `SKILL.md` is injected only when the agent
+decides the skill is needed. Do not pre-load all skills at session start.
+See `agents-docs/AVAILABLE_SKILLS.md`.
+
+### Custom Commands
+Project slash commands live in `.claude/commands/`. Use them for repeatable workflows.
+
+### Hooks
+Verification hooks run automatically on agent stop events.
+- Exit `0` = silent success (nothing extra enters context)
+- Exit `2` = errors surfaced to agent, forcing remediation before finishing
+See `agents-docs/HOOKS.md`.
+
+### Headless / CI Mode
+```bash
+claude -p "your prompt" --output-format stream-json
+```
+
+### Context Management
+- Use `/clear` between unrelated tasks
+- Use `Glob`/`Grep` to find code instead of reading whole file trees
+- Prefer sub-agents for multi-step research tasks
+- See `agents-docs/CONTEXT.md`
diff --git a/.agents/manifest.json b/.agents/manifest.json
@@ -1,6 +1,8 @@
 {
   "version": "1.0.0",
+  "canonical_instructions": "AGENTS.md",
   "canonical_skills": ".agents/skills",
+  "skill_labeler": ".github/labeler.yml",
   "global_docs": [
     "AGENTS.md",
     "README.md"
@@ -12,33 +14,34 @@
       "docs": [
         "CLAUDE.md"
       ],
-      "symlink_strategy": "relative"
+      "instruction_addendum": ".agents/instructions/claude.md",
+      "symlink_strategy": "relative-entries"
     },
     "gemini": {
       "directory": ".gemini",
       "skills_directory": ".gemini/skills",
       "docs": [
         "GEMINI.md"
       ],
-      "symlink_strategy": "relative"
+      "symlink_strategy": "relative-entries"
     },
     "qwen": {
       "directory": ".qwen",
       "skills_directory": ".qwen/skills",
       "docs": [
         "QWEN.md"
       ],
-      "symlink_strategy": "relative"
+      "symlink_strategy": "relative-entries"
     },
     "cursor": {
       "directory": ".cursor",
       "skills_directory": ".cursor/skills",
-      "symlink_strategy": "relative"
+      "symlink_strategy": "relative-directory"
     },
     "windsurf": {
       "directory": ".windsurf",
       "skills_directory": ".windsurf/skills",
-      "symlink_strategy": "relative"
+      "symlink_strategy": "relative-directory"
     },
     "opencode": {
       "directory": ".opencode",

diff --git a/.claude/skills/deepsource b/.claude/skills/deepsource
@@ -0,0 +1 @@
+../../.agents/skills/deepsource
diff --git a/.claude/skills/static-analysis-suppression b/.claude/skills/static-analysis-suppression
@@ -0,0 +1 @@
+../../.agents/skills/static-analysis-suppression
diff --git a/.claude/skills/vercel-deployment b/.claude/skills/vercel-deployment
@@ -0,0 +1 @@
+../../.agents/skills/vercel-deployment
diff --git a/.claude/skills/verify-before-asserting b/.claude/skills/verify-before-asserting
@@ -0,0 +1 @@
+../../.agents/skills/verify-before-asserting
diff --git a/.gemini/skills/deepsource b/.gemini/skills/deepsource
@@ -0,0 +1 @@
+../../.agents/skills/deepsource
diff --git a/.gemini/skills/static-analysis-suppression b/.gemini/skills/static-analysis-suppression
@@ -0,0 +1 @@
+../../.agents/skills/static-analysis-suppression
diff --git a/.gemini/skills/vercel-deployment b/.gemini/skills/vercel-deployment
@@ -0,0 +1 @@
+../../.agents/skills/vercel-deployment
diff --git a/.gemini/skills/verify-before-asserting b/.gemini/skills/verify-before-asserting
@@ -0,0 +1 @@
+../../.agents/skills/verify-before-asserting
diff --git a/.github/labeler.yml b/.github/labeler.yml
diff --git a/.gitignore b/.gitignore
@@ -65,7 +65,11 @@ test.db
 
 # Agent scratch / taste
 .commandcode/
-.claude/
+# Keep Claude-local state ignored, but track manifest-managed skill links.
+.claude/*
+!.claude/skills/
+.claude/skills/*
+!.claude/skills/*
 .mimocode/plans/
 
 # === Next.js redesign additions ===

diff --git a/.qwen/skills/deepsource b/.qwen/skills/deepsource
@@ -0,0 +1 @@
+../../.agents/skills/deepsource
diff --git a/.qwen/skills/static-analysis-suppression b/.qwen/skills/static-analysis-suppression
@@ -0,0 +1 @@
+../../.agents/skills/static-analysis-suppression
diff --git a/.qwen/skills/vercel-deployment b/.qwen/skills/vercel-deployment
@@ -0,0 +1 @@
+../../.agents/skills/vercel-deployment
diff --git a/.qwen/skills/verify-before-asserting b/.qwen/skills/verify-before-asserting
@@ -0,0 +1 @@
+../../.agents/skills/verify-before-asserting
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		../../.agents/skills/static-analysis-suppression