@su-record/vibe 3.2.64 → 4.0.0

package/skills/vibe.commit-push-pr/agents/reviewer.md

@@ -1,52 +0,0 @@
----
-name: reviewer
-role: Reviews commit message and PR body for quality before submission
-tools: [Read, Bash]
----
-
-# Reviewer
-
-## Role
-Final quality gate before the commit is created and the PR is opened. Checks that the commit message and PR body meet quality standards and accurately reflect the change analysis. Blocks submission if critical issues are found.
-
-## Responsibilities
-- Verify commit subject line follows Conventional Commits format and is under 72 chars
-- Check that commit body explains motivation, not just what changed
-- Confirm PR title is under 70 characters and matches the commit type
-- Verify PR body has all required sections: Summary, Motivation, Test Plan
-- Flag missing BREAKING CHANGE footer if analysis identified API/behavior changes
-
-## Input
-- Commit message from message-writer
-- PR title and body from pr-writer
-- Change analysis report from change-analyzer (ground truth)
-
-## Output
-Quality review verdict:
-
-```markdown
-## Commit/PR Review
-
-### Commit Message
-- [x] Conventional format: fix(auth): ...
-- [x] Subject under 72 chars (61 chars)
-- [x] Body explains motivation
-- [ ] MISSING: BREAKING CHANGE footer — validateToken now returns null, not throws
-
-### PR Body
-- [x] Title under 70 chars
-- [x] Summary section present (3 bullets)
-- [x] Motivation section present
-- [x] Test Plan has manual verification step
-- [ ] MISSING: Notes section should document null-vs-throw behavior change
-
-### Verdict
-BLOCKED — 2 items must be fixed before submission.
-```
-
-## Communication
-- Reports findings to: orchestrator (commit-push-pr skill) / user
-- Receives instructions from: orchestrator
-
-## Domain Knowledge
-BLOCKED verdict requires fix before proceeding. APPROVED verdict allows immediate submission. A BREAKING CHANGE in the diff that is not documented in the commit footer is always a blocker. "What changed" in PR body is informational; "Why it changed" is required.

package/skills/vibe.commit-push-pr/rubrics/commit-message.md

@@ -1,73 +0,0 @@
-# Commit Message Format Rubric
-
-## Structure
-
-```
-<type>(<scope>): <subject>          ← 50 chars max, imperative mood
-                                    ← blank line
-<body>                              ← 72 chars/line wrap, explain WHY
-                                    ← blank line
-<footer>                            ← Co-Authored-By, Closes #N
-```
-
-## Types
-
-| Type | When to Use |
-|------|-------------|
-| `feat` | New feature or capability |
-| `fix` | Bug fix |
-| `refactor` | Code restructure, no behavior change |
-| `perf` | Performance improvement |
-| `test` | Adding or fixing tests |
-| `docs` | Documentation only |
-| `style` | Formatting, whitespace (no logic change) |
-| `chore` | Build, deps, tooling, CI |
-
-## Subject Line Rules
-
-- Imperative mood: "add feature" not "added feature"
-- No period at end
-- Max 50 characters
-- Scope is optional: `feat(auth): add OAuth login`
-
-## Body Rules
-
-- Explain **why**, not what (code shows what)
-- Wrap at 72 characters
-- Use bullet points for multiple changes
-- Reference issues: `Closes #123`, `Fixes #456`
-
-## Required Footer
-
-```
-Co-Authored-By: Claude <noreply@anthropic.com>
-```
-
-## Examples
-
-```
-feat(auth): add GitHub OAuth login
-
-Users can now sign in with GitHub instead of email/password.
-Reduces friction for developer-focused onboarding flow.
-
-Closes #42
-Co-Authored-By: Claude <noreply@anthropic.com>
-```
-
-```
-fix(api): prevent null reference on empty search results
-
-The search endpoint crashed when no results matched.
-Added early return with empty array instead.
-
-Co-Authored-By: Claude <noreply@anthropic.com>
-```
-
-## Rejection Criteria
-
-- Subject over 50 chars
-- Missing Co-Authored-By line
-- Past tense in subject ("added", "fixed")
-- Subject with period at end
-- No body when change is non-trivial

package/skills/vibe.commit-push-pr/templates/pr-body.md

@@ -1,63 +0,0 @@
-# PR Body Template
-
-Use this template with `gh pr create --body "$(cat <<'EOF' ... EOF)"`.
-
----
-
-## Summary
-
-- {{CHANGE_1}}
-- {{CHANGE_2}}
-- {{CHANGE_3}}
-
-## Motivation
-
-{{WHY_THIS_CHANGE — business reason or problem being solved}}
-
-## Related Issues
-
-- Closes #{{ISSUE_NUMBER}}
-
-## Test Plan
-
-- [ ] {{TEST_STEP_1}}
-- [ ] {{TEST_STEP_2}}
-- [ ] {{TEST_STEP_3}}
-
-## Screenshots / Demo
-
-{{ATTACH_SCREENSHOT_OR_REMOVE_SECTION}}
-
----
-
-{{SESSION_URL}}
-
----
-
-## Usage Notes
-
-**Minimal PR (bug fix, chore):**
-
-```
-## Summary
-- {{CHANGE}}
-
-## Related Issues
-- Fixes #{{ISSUE_NUMBER}}
-
-{{SESSION_URL}}
-```
-
-**Feature PR:**
-
-Use the full template above. Screenshots required for UI changes.
-
-**Breaking Change:**
-
-Add this section at the top:
-
-```
-## BREAKING CHANGE
-
-{{WHAT_BREAKS}} — {{MIGRATION_STEPS}}
-```

package/skills/vibe.context7-usage/SKILL.md

@@ -1,11 +0,0 @@
----
-name: vibe.context7-usage
-description: Compatibility alias for Context7-based current library documentation lookup. Use when callers invoke vibe.context7-usage directly.
-invocation: [auto]
-tier: optional
-triggers: [latest version, official docs, API reference, library help, context7]
-priority: 60
-user-invocable: true
----
-
-Load `vibe.documentation-provider` and force the Context7 provider while preserving all arguments.

package/skills/vibe.continue/SKILL.md

@@ -1,42 +0,0 @@
----
-name: vibe.continue
-description: 세션을 넘기거나 이전 작업을 계속해야 할 때 — reset 전 HANDOFF.md를 만들거나 최신 handoff/checkpoint에서 상태를 복원한다.
-argument-hint: "[handoff]"
-user-invocable: true
----
-
-# /vibe.continue
-
-## Done Criteria
-
-- [ ] handoff mode에서는 HANDOFF.md가 지정 경로에 존재한다.
-- [ ] restore mode에서는 복원한 checkpoint 또는 handoff 경로가 보고된다.
-- [ ] 현재 목표, 변경 파일, 검증 상태, 다음 작업이 결과에 포함된다.
-
-Restore previous session context for continuity.
-
-## Usage
-
-```
-/vibe.continue
-/vibe.continue handoff
-```
-
-## Process
-
-- **Restore mode** (default): locate the newest project checkpoint,
-  `HANDOFF.md`, and `.vibe/memories/` record; read them in full, reconstruct
-  completed work and the next step, verify against `git status`, then resume.
-- **Handoff mode**: read `references/handoff.md`, generate `HANDOFF.md`, read it
-  back, and verify its tasks, decisions, changed files, branch, and test status
-  against repository state.
-
-## When to Use
-
-- At new session start, to pick up exactly where the previous session left off
-- At 85%+ context usage: persist a checkpoint/handoff → start a fresh session using the harness's session reset → `/vibe.continue`
-- Invoke the `vibe.handoff` compatibility name when an existing workflow expects it; it delegates to handoff mode.
-
----
-
-ARGUMENTS: $ARGUMENTS

package/skills/vibe.continue/agents/context-summarizer.md

@@ -1,51 +0,0 @@
----
-name: context-summarizer
-role: Summarizes decisions made during the session and their rationale
-capabilities: [full-file-reading, shell-command-execution]
----
-
-# Context Summarizer
-
-## Role
-Distills the session's reasoning into a compact decision log. Captures the "why" behind architectural and implementation choices so the next session (or developer) doesn't re-litigate resolved questions.
-
-## Responsibilities
-- Review recent conversation context for key decisions and trade-offs
-- Summarize rejected alternatives and the reason they were rejected
-- Identify blockers that were encountered and how they were resolved
-- Note any assumptions made that should be validated later
-- Flag unresolved debates or open questions for the next session
-
-## Input
-- State snapshot from state-collector
-- Session conversation context (decisions, debates, trade-offs discussed)
-
-## Output
-Decision log section for HANDOFF.md:
-
-```markdown
-## Decisions & Rationale
-
-### Decided: JWT over sessions
-Chose stateless JWT for auth because the API must support mobile clients.
-Rejected: server-side sessions — would require sticky sessions in Kubernetes.
-
-### Decided: Skip refresh token for now
-Deferred refresh token implementation — out of scope for this sprint.
-Risk: tokens expire after 1h, users must re-login.
-
-### Open Questions
-- Should we store token revocation list in Redis or Postgres?
-- Confirm with team: is 1h token TTL acceptable for mobile?
-
-### Assumptions Made
-- Mobile client handles 401 → re-login flow gracefully
-- Redis will be available in production (not confirmed)
-```
-
-## Communication
-- Reports findings to: document-writer
-- Receives instructions from: orchestrator (handoff skill)
-
-## Domain Knowledge
-Decisions without rationale are useless. Every decision entry must include: what was decided, why, and what was rejected with reason. Keep each entry under 3 lines.

package/skills/vibe.continue/agents/document-writer.md

@@ -1,63 +0,0 @@
----
-name: document-writer
-role: Writes HANDOFF.md from collected state data and session summary
-capabilities: [file-editing, full-file-reading, shell-command-execution]
----
-
-# Document Writer
-
-## Role
-Assembles the final HANDOFF.md by combining the state snapshot and decision log into a structured document that enables the next session to continue without any ramp-up time.
-
-## Responsibilities
-- Merge state-collector data and context-summarizer output into one document
-- Write completed tasks, in-progress tasks (with % and next step), and next tasks
-- Include notes on known bugs, workarounds, and files to avoid
-- List all relevant modified files with a one-line description of each
-- Save the document to the project root as `HANDOFF.md`
-
-## Input
-- State snapshot from state-collector
-- Decision log from context-summarizer
-- Any explicit notes provided by the user
-
-## Output
-`HANDOFF.md` written to project root:
-
-```markdown
-# Work Handover Document
-
-## Completed Tasks
-- [x] JWT auth middleware implemented and tested
-
-## In Progress
-- [ ] Refresh token flow — 40% complete
-  - Next step: implement POST /auth/refresh endpoint
-
-## Next Tasks
-1. Add rate limiting to /auth/login
-2. Write integration tests for token expiry edge cases
-
-## Decisions & Rationale
-{from context-summarizer}
-
-## Notes & Cautions
-- Do not touch src/legacy-auth.ts — will be removed next sprint
-- Known bug: FIXME in src/middleware.ts:18
-
-## Related Files
-- src/auth.ts — JWT validation logic
-- src/types.ts — AuthToken and User types
-
-## Last State
-- Branch: feature/auth-refactor
-- Last commit: abc1234
-- Test status: PASSING (24/24)
-```
-
-## Communication
-- Reports findings to: verifier
-- Receives instructions from: orchestrator (handoff skill)
-
-## Domain Knowledge
-Write for a developer with zero session context. The next person reading this has no memory of what happened. Every section must be self-contained.

package/skills/vibe.continue/agents/state-collector.md

@@ -1,53 +0,0 @@
----
-name: state-collector
-role: Gathers current branch, commits, test status, and open TODOs for handoff
-capabilities: [shell-command-execution, file-pattern-search, text-search, full-file-reading]
----
-
-# State Collector
-
-## Role
-Takes a snapshot of the current repository state so the handoff document reflects reality. Collects factual, objective data — not interpretation. Feeds raw data to context-summarizer and document-writer.
-
-## Responsibilities
-- Run `git status`, `git branch`, and `git log --oneline -10` to capture branch and commit state
-- Run the test suite (or last known test run) to record pass/fail counts
-- Scan for open TODO/FIXME/HACK comments in recently changed files
-- List all files modified since the last commit
-- Check for any stashed changes or untracked files
-
-## Input
-- Project root path
-- Optional: test command override (defaults to `npm test` or `npx vitest run`)
-
-## Output
-Raw state data bundle:
-
-```markdown
-## State Snapshot
-
-### Git State
-- Branch: feature/auth-refactor
-- Last commit: abc1234 "Add JWT validation"
-- Uncommitted changes: 3 files (src/auth.ts, src/types.ts, tests/auth.test.ts)
-- Stashed: none
-
-### Test Status
-- Last run: PASSING (24 passed, 0 failed)
-- Coverage: 87%
-
-### Open TODOs
-- src/auth.ts:42 — TODO: handle refresh token expiry
-- src/middleware.ts:18 — FIXME: rate limiter not applied to /health
-
-### Modified Files (since last commit)
-- src/auth.ts
-- src/types.ts
-```
-
-## Communication
-- Reports findings to: document-writer, context-summarizer
-- Receives instructions from: orchestrator (handoff skill)
-
-## Domain Knowledge
-Collect facts, not interpretation. If a test run hasn't happened, state that explicitly. If git state is dirty, list every uncommitted file.

package/skills/vibe.continue/agents/verifier.md

@@ -1,48 +0,0 @@
----
-name: verifier
-role: Checks handoff completeness against the HANDOFF.md rubric
-capabilities: [full-file-reading, shell-command-execution]
----
-
-# Verifier
-
-## Role
-Reviews the generated HANDOFF.md against a completeness rubric before the session ends. Flags any missing or vague sections and either requests fixes from document-writer or escalates to the user.
-
-## Responsibilities
-- Check all required sections are present and non-empty
-- Verify "In Progress" items each have a % complete and "Next step"
-- Confirm the git branch, last commit hash, and test status are recorded
-- Ensure "Related Files" lists every file from the state snapshot
-- Validate that open questions are explicitly marked, not buried in prose
-
-## Input
-- HANDOFF.md written by document-writer
-- State snapshot from state-collector (ground truth for cross-checking)
-
-## Output
-Verification report:
-
-```markdown
-## Handoff Verification
-
-### Rubric Check
-- [x] Completed tasks listed
-- [x] In-progress tasks have % and next step
-- [x] Next tasks prioritized
-- [ ] MISSING: Open questions section not found
-- [x] Related files match modified files
-- [x] Branch and commit recorded
-- [x] Test status recorded
-
-### Verdict
-INCOMPLETE — 1 item must be fixed before session ends.
-Fix: add ## Open Questions section with 2 unresolved items from context-summarizer.
-```
-
-## Communication
-- Reports findings to: orchestrator (handoff skill) / user
-- Receives instructions from: orchestrator
-
-## Domain Knowledge
-Rubric thresholds: 0 blockers = COMPLETE. Any missing required section = INCOMPLETE. Optional sections (Assumptions, Decisions) are best-effort. A HANDOFF.md that scores INCOMPLETE must be revised before the session closes.

package/skills/vibe.continue/references/handoff-completeness.md

@@ -1,62 +0,0 @@
-# Handoff Completeness Rubric
-
-A HANDOFF.md is complete only when all required items are present and accurate.
-
-## Required Sections (all must be filled)
-
-### Status Block
-- [ ] Build status is current (run `npm run build` immediately before writing)
-- [ ] Test status is current (run `npx vitest run` immediately before writing)
-- [ ] Branch name matches `git branch --show-current`
-- [ ] Last commit hash is correct (`git log --oneline -1`)
-
-### Completed Work
-- [ ] At least one item listed (even if just "initial exploration")
-- [ ] Each item is specific enough to be verifiable
-- [ ] No vague entries like "worked on auth"
-
-### In Progress
-- [ ] The single task currently active is identified
-- [ ] The exact next step is described (not "continue working on X")
-- [ ] Any blocking question is explicitly stated or marked "none"
-- [ ] At least one "where to look first" file is listed
-
-### Remaining Tasks
-- [ ] All known remaining tasks are listed
-- [ ] Each task has a P1/P2/P3 priority label
-- [ ] Tasks are ordered by priority
-
-### Decisions Made
-- [ ] Any architectural or design decisions from this session are recorded
-- [ ] Rationale is included (not just "we decided X")
-- [ ] Rejected alternatives noted where non-obvious
-
-### Modified Files
-- [ ] `git status` output or equivalent is included
-- [ ] Every modified file is present (no omissions)
-
-### Resume Instructions
-- [ ] The exact command to restore context is present
-- [ ] The exact point to resume from is described
-
-## Optional but Strongly Recommended
-
-- Known issues / workarounds (if any discovered this session)
-- "Do not touch" warnings (if any fragile areas identified)
-- Optional harness memory references, when the active harness provides durable memory
-
-## Quality Bar
-
-| Criterion | Pass |
-|-----------|------|
-| A new session can start without asking any clarifying questions | Required |
-| The next developer can find the relevant files within 60 seconds | Required |
-| Build/test status reflects reality at time of handoff | Required |
-| Handoff written within 5 minutes of session end | Recommended |
-
-## Failure Modes to Avoid
-
-- Writing completed tasks from memory instead of `git log` — use actual git output
-- Listing "in progress" without a concrete next step — be specific
-- Omitting the current branch — always include
-- Skipping the status block — it expires; run commands fresh

package/skills/vibe.continue/references/handoff.md

@@ -1,142 +0,0 @@
-# Handoff Workflow and Canonical HANDOFF.md Template
-
-Use this document before a session ends or a long pause when detailed work state must survive context reset. `vibe.continue` restores state; handoff mode first records progress, decisions, changed files, verification status, and the exact next step in `HANDOFF.md`.
-
-## When to Generate
-
-- Context reaches the harness's own threshold — the `context_window_80/90/95` signal, i.e. the 85% rule in CLAUDE.md. Do not hardcode an absolute token count: the window differs by model (200k vs 1M), so a fixed number is wrong for most sessions.
-- The session has already been compacted three times.
-- Work will pause for an extended period.
-- Complex progress needs a durable record for a teammate or future session.
-
-Automatic continue restores available session state at the start of a new session; HANDOFF.md is the manual, repository-verifiable record created before the old session ends. They complement rather than replace each other.
-
-## Generation Procedure
-
-1. Inspect `git status` and the five most recent commits.
-2. Separate completed, in-progress, and remaining work.
-3. Fill every applicable template field below from conversation and repository evidence.
-4. Write `HANDOFF.md`, then read it back and verify it against repository state.
-5. Durable harness memory may mirror the document, but is optional and never the correctness source.
-
-## Restore Procedure
-
-Run `vibe.continue`, read `HANDOFF.md`, and verify its branch, changed files, and test status before resuming from `Next immediate step`.
-
-## Done Criteria
-
-- [ ] HANDOFF.md exists with all applicable sections filled.
-- [ ] Completed, in-progress, and remaining tasks match repository state.
-- [ ] All modified files and the last commit are recorded.
-- [ ] Session decisions, cautions, blockers, and exact next step are present.
-- [ ] The written document was read back and checked against Git and test evidence.
-
----
-
-# Work Handover: {{FEATURE_OR_TASK_NAME}}
-
-**Date**: {{DATE}}
-**Branch**: {{GIT_BRANCH}}
-**Author**: {{AUTHOR}}
-**Session context**: {{CONTEXT_PERCENT}}% used
-
----
-
-## Status at Handoff
-
-| Area | Status | Notes |
-|------|--------|-------|
-| Build | {{BUILD_STATUS}} | `npm run build` |
-| Tests | {{TEST_STATUS}} | `npx vitest run` |
-| Type check | {{TYPECHECK_STATUS}} | `npx tsc --noEmit` |
-| Lint | {{LINT_STATUS}} | |
-
----
-
-## Completed Work
-
-- [x] {{COMPLETED_TASK_1}}
-- [x] {{COMPLETED_TASK_2}}
-- [x] {{COMPLETED_TASK_3}}
-
-Last commit: `{{LAST_COMMIT_HASH}}` — {{LAST_COMMIT_MESSAGE}}
-
----
-
-## In Progress (resume here)
-
-### {{IN_PROGRESS_TASK_NAME}}
-
-- Progress: {{PROGRESS_PERCENT}}%
-- Current state: {{CURRENT_STATE_DESCRIPTION}}
-- Next immediate step: {{NEXT_STEP}}
-- Blocking question (if any): {{BLOCKER_OR_NONE}}
-
-**Where to look first:**
-- `{{KEY_FILE_1}}` — {{KEY_FILE_1_CONTEXT}}
-- `{{KEY_FILE_2}}` — {{KEY_FILE_2_CONTEXT}}
-
----
-
-## Remaining Tasks (in priority order)
-
-1. **[P1]** {{P1_TASK}} — must complete before merge
-2. **[P2]** {{P2_TASK}} — complete before PR review
-3. **[P3]** {{P3_TASK}} — nice-to-have
-
----
-
-## Decisions Made This Session
-
-| Decision | Rationale | Alternatives Rejected |
-|----------|-----------|----------------------|
-| {{DECISION_1}} | {{RATIONALE_1}} | {{ALTERNATIVES_1}} |
-| {{DECISION_2}} | {{RATIONALE_2}} | {{ALTERNATIVES_2}} |
-
----
-
-## Do Not Touch
-
-- `{{FRAGILE_FILE_1}}` — {{REASON_1}}
-- `{{FRAGILE_FILE_2}}` — {{REASON_2}}
-
----
-
-## Known Issues / Workarounds
-
-- {{KNOWN_ISSUE_1}}
-- {{KNOWN_ISSUE_2}}
-
----
-
-## All Modified Files
-
-```
-{{GIT_STATUS_OUTPUT}}
-```
-
----
-
-## How to Resume
-
-```bash
-# 1. Load context
-/vibe.continue
-
-# 2. Read this file if context is missing
-# cat HANDOFF.md
-
-# 3. Verify baseline
-npm run build && npx vitest run
-
-# 4. Pick up from: {{RESUME_INSTRUCTION}}
-```
-
----
-
-## Optional Session Memory References
-
-When the active harness provides durable memory, record its references here:
-
-- `{{MEMORY_KEY_1}}` — {{MEMORY_KEY_1_DESCRIPTION}}
-- `{{MEMORY_KEY_2}}` — {{MEMORY_KEY_2_DESCRIPTION}}