Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion .agents/rules/code-core.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: code-core
description: Workflow rules shared by every code repo - DocVault, glossary, Plane, Infisical, debugging, memory, code search, editing, tests, spec gates, push rules, red flags, GitHub hygiene
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Code-core rules
Expand Down Expand Up @@ -90,6 +90,11 @@ needs no secrets. Never hard-code an Infisical project ID anywhere else; read it
## Debugging

- Do not rationalize a discrepancy without evidence. Reproduce it from data or code first, then explain it.
- Before you state a cause, list two or three candidates with one check each, and run the checks. Call a
workaround a workaround; the user wants the root cause fixed.
- Never write an identifier (commit SHA, UUID, issue ID, port, path) that no tool output in this context
printed. Look it up first.
- Do not advise a new session or an app restart unless a check shows it will help.
- Dates and times: check whether a computation uses the UTC date or the local date (America/Chicago).
Never slice ISO strings for day bucketing.
- DNS: `nslookup`/`dig` bypass the macOS resolver cache. Use `dscacheutil -q host -a name <host>` to test
Expand Down
2 changes: 1 addition & 1 deletion .agents/rules/prose-core.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---
# Prose-core rules

Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/codacy-analysis-cli/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ license: MIT
metadata:
author: Codacy
version: 1.5.0
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Codacy Analysis CLI
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/codacy-cloud-cli/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ license: MIT
metadata:
author: Codacy
version: 1.6.1
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Codacy Cloud CLI
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/codacy-code-review/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ license: MIT
metadata:
author: Codacy
version: 1.5.0
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Codacy Code Review
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/code-review/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name: code-review
description: "Run CodeRabbit CLI reviews, retrieve saved local or GitHub PR fix prompts, and interpret CodeRabbit authentication and review output. Use for CodeRabbit review commands, committed/uncommitted or directory scopes, and CodeRabbit runbooks. Default code-review skill: also trigger for explicit code/PR/quality/security review requests or when a review is needed."
metadata:
version: "0.1.0"
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# CodeRabbit Code Review
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/context-drift/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ description: >-
`/vault-drift` for projects migrated to `.context/` (DEVS-37). Triggers: "context drift", "vault drift", "drift audit", "drift check",
"context-drift", "audit .context", "check context docs", "foundation drift", "verify foundation",
"what should be in .context".
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Context Drift
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/discernment-nudge/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ description: >
to double-check, cite, or review — the skill file explains these
boundaries and the exact output format.
license: Complete terms in LICENSE.txt
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Discernment nudge
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/discover/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ description: >
Triggers on "/discover", "/brainstorm", "research this issue", "explore this
before we spec it".
user-invocable: true
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Discover — Phase 1 Structured Brainstorm
Expand Down
5 changes: 3 additions & 2 deletions .agents/skills/issue/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
Triggers on: "create issue", "issue", "new issue", "new bug", "file a bug",
"track this".
user-invocable: false
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Issue Management
Expand Down Expand Up @@ -38,7 +38,8 @@
mcp__plane__label action: "list", project_id: {plane_project_id}
```

Map names → uuids. Cache for the rest of the session.
Map names → uuids. Use a UUID only from a list result still in your context; after a compaction, list

Check notice on line 41 in .agents/skills/issue/SKILL.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

.agents/skills/issue/SKILL.md#L41

Expected: 80; Actual: 104
again. Never type a state or label UUID from memory or from another project.

2. **Pick state and label from user intent:**

Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/pr-cleanup/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: >
local branches and their worktrees, pulls main fast-forward, and reports the result.
Run after a PR is merged, before /wrap.
Triggers: "pr-cleanup", "clean up branches", "prune worktrees", "clean after merge".
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# PR Cleanup
Expand Down
10 changes: 5 additions & 5 deletions .agents/skills/pr-resolve/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: pr-resolve
description: PR resolve — work through open PR review threads and Codacy issues to get a PR approved and merged.
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# PR Resolve
Expand Down Expand Up @@ -215,13 +215,13 @@
# (broad-add risks committing .env, untracked agent scratch, or unrelated edits).
# Enumerate the file set from the cluster reports and pass them explicitly:
git add path/to/file1 path/to/file2 ...
git commit -m "fix: resolve PR review findings (PR #XX)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>"
git commit -m "fix: resolve PR review findings (PR #XX)"
git push origin <branch>
SHA=$(git rev-parse --short HEAD)
git fetch origin <branch> && git merge-base --is-ancestor "$SHA" "origin/<branch>" && echo "$SHA on remote"

Check notice on line 221 in .agents/skills/pr-resolve/SKILL.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

.agents/skills/pr-resolve/SKILL.md#L221

Expected: 80; Actual: 107
```

4. **Post replies and resolve threads.** For each cluster's resolution report, post the reply and resolve the thread:
4. **Post replies and resolve threads.** Replace every `{SHA}` placeholder in the cluster replies with `$SHA` from step 3. Do not post a reply whose SHA was not printed by git in this session. Then post the reply and resolve the thread:

```bash
# Reply to thread
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/receiving-code-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: receiving-code-review
description: Receiving code review feedback — verify before implementing, never blindly agree.
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Code Review Reception
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/requesting-code-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: requesting-code-review
description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Requesting Code Review
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/setup-foundation-context/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ description: >-
copies. Dry-run by default. Run once per project in a fresh session. Operationalizes
DEVS-37. Triggers: "/setup-foundation-context", "setup foundation context", "migrate
foundation docs to .context", "onboard foundation docs", "context foundation setup".
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Setup Foundation Context
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/spec-approach/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
name: spec-approach
description: "Spec Phase 3 — architecture, key decisions, file map (+ UI Contract) into approach.md. Standalone, ISSUE-first. Reads universal + per-project conventions."
user-invocable: true
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# /spec-approach ISSUE
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/spec-discovery/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
name: spec-discovery
description: "Spec Phase 2 — research the codebase + prior art into discovery.md. Standalone, ISSUE-first. Uses a read-only Workflow fan-out for the research sweep."
user-invocable: true
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# /spec-discovery ISSUE
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/spec-reconcile/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
name: spec-reconcile
description: "Spec process step — classify /spec-review marks for one phase, apply them with human approval, archive the originals. ISSUE PHASE first."
user-invocable: true
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# /spec-reconcile ISSUE PHASE
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/spec-requirements/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
name: spec-requirements
description: "Spec Phase 1 — grill the issue, then draft requirements.md in EARS. Standalone, ISSUE-first. Reads universal conventions + per-project overrides."
user-invocable: true
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# /spec-requirements ISSUE
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/spec-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: spec-review
description: "Reviewer-side /spec peer review. Reviews one phase of an active spec against the codebase."
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# /spec-review
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/spec-tasks/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
name: spec-tasks
description: "Spec Phase 4 — break approach into a TDD sprint-cohort checklist in tasks.md. Standalone, ISSUE-first. Reads universal + per-project conventions and the tasks template."
user-invocable: true
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# /spec-tasks ISSUE
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/spec/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
name: spec
description: "Phased spec workflow above a quick fix. Driver for the /spec-* phase family + execution engines (run/workflow/dispatch). Phased markdown artifacts in the repo's specs root (specs.path in .claude/project.json, default DocVault/specs/)."
user-invocable: true
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Spec — Phased Spec Workflow (driver)
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/start/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ description: >
for continuing same-day work or resuming after a short break.
No indexing, no code search, no agent dispatch.
Triggers: "start", "quick start", "resume", "orient me", "where were we".
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Start
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/vault-update/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >
architecture decisions are made, or project docs need updating. Triggers on: "update vault",
"vault update", "docvault", "update docs", "add to vault", "vault"
user-invocable: true
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Vault Update
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/verification-before-completion/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: verification-before-completion
description: Run verification commands before claiming work is complete. Evidence before assertions.
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Verification Before Completion
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/wrap/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >
facts to .context/, syncs docs, and reports Session Health. Run at end of any session, optionally after
/pr-cleanup. Triggers: "wrap", "wrap up", "close session", "end of session",
"done for the night", "finish up", "closing time".
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Wrap Session
Expand Down
2 changes: 1 addition & 1 deletion .claude/agents/firecrawl-scraper.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
name: firecrawl-scraper
description: "Web scraping and research subagent. Dispatched to scrape URLs, search the web, crawl sites, and extract structured data using the self-hosted Firecrawl MCP tools. Returns distilled results to keep the main context clean."
model: haiku
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

You are a web scraping specialist. You are dispatched by the orchestrator to fetch, extract, and distill web content. Your job is to do the scraping work and return only the useful results — never dump raw HTML or full page markdown back to the caller unless explicitly asked.
Expand Down
2 changes: 1 addition & 1 deletion .claude/agents/pr-discover.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
name: pr-discover
description: "PR discovery and pre-analysis agent. Gathers all PR review threads, Codacy findings, runs code review subagents, and returns a structured findings report with file-based thread clusters. Dispatched by /pr-resolve to isolate the heavy data-gathering phases from main context."
model: sonnet
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# PR Discovery & Pre-Analysis Agent
Expand Down
14 changes: 9 additions & 5 deletions .claude/agents/pr-thread-resolver.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
name: pr-thread-resolver
description: "Resolves a cluster of PR review threads grouped by file/topic. Dispatched in parallel by pr-resolve for independent clusters. Re-fetches thread IDs via GraphQL before acting to handle intervening rebases. Makes code fixes, generates replies, and returns results for the orchestrator to post."
model: sonnet
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

You are a PR thread cluster resolver. You receive a cluster of classified review threads (all on the same file or topic) and execute the resolutions — fixing code, generating replies, or both. Multiple clusters run in parallel, but within your cluster you handle threads sequentially to avoid edit conflicts.
Expand Down Expand Up @@ -85,11 +85,14 @@

### Resolved (already fixed)

Find the commit that fixed the issue:
Find the commit that fixed the issue on the PR head, not on local `HEAD`:
```bash
git log --oneline --all --max-count=5 -- <file>
git fetch -q origin "pull/<prNumber>/head"
git log --oneline --max-count=5 FETCH_HEAD -- <file>
```

Every SHA this prints is on the PR head. Cite only a SHA that these commands printed. If no commit confirms the fix, report the thread as "Fix now" or unresolved.

Check notice on line 94 in .claude/agents/pr-thread-resolver.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

.claude/agents/pr-thread-resolver.md#L94

Expected: 80; Actual: 162

### Skill Required

The fix requires invoking a project skill (e.g., `/update-spot-bundle`, `/release`). Use the Skill tool:
Expand Down Expand Up @@ -125,7 +128,7 @@
**Comment ID:** <current_comment_id>
**Fix:** <what you changed and why>
**Files modified:** <paths>
**Reply text:** Fixed — <description of change>
**Reply text:** Fixed in `{SHA}` — <description of change>

#### Thread T2 — <file>:<line>
**Classification:** False positive
Expand All @@ -151,7 +154,8 @@
- **Re-fetch is mandatory.** Never skip Phase 0. A 30-second-old discovery can have stale IDs after a force-push.
- **Don't resolve threads yourself.** Return the reply text and thread IDs — the orchestrator posts replies and resolves threads.
- **Don't commit.** Stage fixes with `git add` but don't commit. The orchestrator batches.
- **Be precise in replies.** Cite specific code, commit SHAs, or technical reasons.
- **Be precise in replies.** Cite specific code (`file:line`) or technical reasons.
- **Never write an identifier you did not read.** A fix commit does not exist yet, so a "Fix now" reply keeps the literal `{SHA}` placeholder; the orchestrator fills it after the push. Any other SHA, issue ID or UUID must come from a command output in this run.

Check notice on line 158 in .claude/agents/pr-thread-resolver.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

.claude/agents/pr-thread-resolver.md#L158

Expected: 80; Actual: 261
- **For "Fix now" items, actually fix the code.** Don't just describe what should change.
- **If you can't determine the right fix,** report back with what you found and let the orchestrator decide.
- **Sequential within cluster.** Process threads in order. If thread T2's fix depends on T1's edit, read the file fresh after T1's edit lands.
Expand Down
2 changes: 1 addition & 1 deletion .claude/hooks/block-pr-merge.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
# library-version: e3dbf30dcd3c
# library-version: 4b65e212cbd7
"""PreToolUse hook: force human approval for any PR merge.

Merging a PR is a human-gated activity. Green CI is NOT authorization.
Expand Down
2 changes: 1 addition & 1 deletion .claude/hooks/docvault-lint.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
# library-version: e3dbf30dcd3c
# library-version: 4b65e212cbd7
"""Post-edit lint hook for DocVault vaults — markdownlint + frontmatter + wikilink checks.

DEVS-78: any `*/DocVault/**` file is a vault page (project vaults in each repo, the shared
Expand Down
2 changes: 1 addition & 1 deletion .claude/hooks/vale-staged.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
# library-version: e3dbf30dcd3c
# library-version: 4b65e212cbd7
"""PostToolUse hook: report Vale alerts on the lines a `git commit` added.

It lints a snapshot of HEAD, so the text and line numbers match the commit, whatever the
Expand Down
2 changes: 1 addition & 1 deletion .claude/hooks/worktree-safety.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
# library-version: e3dbf30dcd3c
# library-version: 4b65e212cbd7
"""PreToolUse hook — warns when an Edit/Write targets a file outside the active worktree.

Catches the common mistake of editing files in the main repo checkout when
Expand Down
7 changes: 6 additions & 1 deletion .claude/rules/code-core.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: code-core
description: Workflow rules shared by every code repo - DocVault, glossary, Plane, Infisical, debugging, memory, code search, editing, tests, spec gates, push rules, red flags, GitHub hygiene
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---

# Code-core rules
Expand Down Expand Up @@ -90,6 +90,11 @@ needs no secrets. Never hard-code an Infisical project ID anywhere else; read it
## Debugging

- Do not rationalize a discrepancy without evidence. Reproduce it from data or code first, then explain it.
- Before you state a cause, list two or three candidates with one check each, and run the checks. Call a
workaround a workaround; the user wants the root cause fixed.
- Never write an identifier (commit SHA, UUID, issue ID, port, path) that no tool output in this context
printed. Look it up first.
- Do not advise a new session or an app restart unless a check shows it will help.
- Dates and times: check whether a computation uses the UTC date or the local date (America/Chicago).
Never slice ISO strings for day bucketing.
- DNS: `nslookup`/`dig` bypass the macOS resolver cache. Use `dscacheutil -q host -a name <host>` to test
Expand Down
2 changes: 1 addition & 1 deletion .claude/rules/prose-core.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
library-version: e3dbf30dcd3c
library-version: 4b65e212cbd7
---
# Prose-core rules

Expand Down
2 changes: 1 addition & 1 deletion .claude/skills/.library-manifest
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Managed by skills-deploy (DEVS-125). Entries here are overwritten or removed by --apply;
# every other skill or agent in this repo is project-owned and never touched.
# library-version: e3dbf30dcd3c
# library-version: 4b65e212cbd7
skill start
skill wrap
skill issue
Expand Down
Loading
Loading