Skip to content

docs: resolve D-1 and fold in reviewer findings for agent/skill dashboard specs - #297

Merged
cbeaulieu-gt merged 1 commit into
mainfrom
docs/agent-skill-specs-d1-resolution
Sep 3, 2026
Merged

docs: resolve D-1 and fold in reviewer findings for agent/skill dashboard specs#297
cbeaulieu-gt merged 1 commit into
mainfrom
docs/agent-skill-specs-d1-resolution

Conversation

@cbeaulieu-gt

Copy link
Copy Markdown
Member

Summary

Finalizes the two scoping specs for milestone #8 (issues #295, #296):

  • docs/superpowers/specs/agent-stats-search.md
  • docs/superpowers/specs/skill-usage-report.md

Both were produced by project-planner as DRAFT with open decisions, then reviewed by project-reviewer (findings: 2 BLOCKING, 1 CONCERN, 2 NIT). This PR:

No code changes — spec files only. Neither issue is closed by this PR; both track the actual feature implementation, which hasn't started.

Test plan

  • N/A — documentation only, no executable changes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01AoLZ2VNs8at1J1DML9NQoL

…oard specs

Both specs (issue #295 agent-stats-search, issue #296 skill-usage-report,
milestone #8) had their D-1 decision confirmed by the user on 2026-09-02:
agent-stats-search -> new top-level Agents tab (b); skill-usage-report ->
new top-level Skills tab (a). Fold in project-reviewer's combined findings
as required changes rather than open questions:

- BLOCKING: the `_renderView` terminal `else` collision isn't closed by
  stacking a new branch ahead of it, since that `else` also dispatches the
  legitimate `advanced` tab. Both specs now require an explicit `advanced`
  branch and explicit no-match handling, landing first in agent-stats-search
  (issue #295), consumed by skill-usage-report (issue #296).
- BLOCKING: cp-utils.js is an undeclared 6th (semantic, not textual)
  collision site -- agent-stats-search promotes CP.esc/CP.agentLeaf/
  CP.AGENT_PATH_SEP; skill-usage-report's R-3 is now conditional on that
  landing first, avoiding re-copying esc() after promotion.
- CONCERN (skill-usage-report): added a footnote distinguishing "invocations"
  (by_skill.invocation_count) from "times invoked" (by_skill_adoption.
  times_invoked) as different counting methods that can legitimately
  diverge, plus explicit "--" cells for the invoked-without-a-pass row.
- NIT: recommend a follow-up issue promoting matchesNameFilter/
  matchesAgentFilter to a single CP.matchesNameFilter; added a
  _VIEW_SUBS key-presence test-gate assertion to both specs' Phase 3.

Recomputed open-decision counts (5->4 for #295, 7->6 for #296) and narrowed
agent-stats-search's touches: frontmatter to drop the per-view-filter-box
files that only apply under the D-1 option not chosen.

Spec updates only, no code touched.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AoLZ2VNs8at1J1DML9NQoL
@coderabbitai

coderabbitai Bot commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)
  • needs-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Team

Run ID: 3e698c94-a8e1-4ec1-a464-ec580189b783

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Comment @coderabbitai help to get the list of available commands.

@cbeaulieu-gt
cbeaulieu-gt merged commit d6280a1 into main Sep 3, 2026
6 checks passed
@cbeaulieu-gt
cbeaulieu-gt deleted the docs/agent-skill-specs-d1-resolution branch September 3, 2026 01:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant