mirror of
https://github.com/PR0M3TH3AN/bitvid.git
synced 2026-10-27 16:02:26 +00:00
Claude
843f1a8c2d
Add three supporting documents for prompt library maintenance: - PROMPT_LIBRARY_STATUS.md: current health, inventory of all 36 prompts, changes this run, known remaining issues - STYLE_GUIDE.md: canonical prompt template, naming conventions, voice/tone guidance, anti-patterns to avoid - RESEARCH_LOG.md: web research on prompt-engineering best practices from Anthropic and OpenAI (2025-2026), with library impact analysis https://claude.ai/code/session_01Nz6FJopPp2YHEscJrRAFNv
6.9 KiB
6.9 KiB
Prompt Library Status
Last updated: 2026-02-12 Run type: Weekly (initial baseline)
Summary
- Total prompts: 36 (21 daily, 15 weekly) + 2 schedulers
- Health: Generally good. Most prompts follow the canonical structure. Several P1/P2 issues fixed this run; two truncated prompts require human attention.
Changes This Run
P1 Fixes (Policy Violations)
| File | Issue | Fix |
|---|---|---|
daily/bitvid-content-audit-agent.md |
Agent name typo: bitvd (missing i) |
Fixed to bitvid-content-audit-agent |
daily/bitvid-content-audit-agent.md |
Emoji in PR title (🌐) |
Removed emoji |
daily/bitvid-docs-alignment-agent.md |
Emoji in PR title (📘) and body (💡🎯✅📌) |
Removed all emoji |
daily/bitvid-perf-agent.md |
Emoji in docs PR title (🌐) |
Removed emoji |
weekly/bitvid-perf-optimization-agent.md |
Emoji in PR title (⚡) and body (💡🎯📊) |
Removed all emoji |
daily/bitvid-style-agent.md |
Identity says bitvid-stylelint-agent but filename is bitvid-style-agent.md |
Fixed identity to match filename |
P2 Fixes (Behavioral Defects)
| File | Issue | Fix |
|---|---|---|
daily/bitvid-docs-code-investigator.md |
AI generation artifacts (:contentReference[oaicite:N]{index=N}) in 4 locations |
Removed all artifacts |
weekly/bitvid-event-schema-agent.md |
Example uses require() but project is ES modules ("type": "module") |
Changed to import syntax |
daily/bitvid-const-refactor-agent.md |
References scripts/find-numeric-literals.js as if it exists (it doesn't) |
Clarified the script must be created first |
weekly/bitvid-interop-agent.md |
File truncated mid-code-block; missing Failure Modes, Outputs sections | Closed code block, added truncation notice |
weekly/bitvid-smoke-agent.md |
File truncated mid-code-block; missing Failure Modes, PR, Outputs sections | Closed code block, added truncation notice |
Known Remaining Issues
Requires Human Action
- bitvid-interop-agent.md — Truncated at line 138. Missing sections: Failure Modes, Outputs Per Run. Needs human to complete the prompt.
- bitvid-smoke-agent.md — Truncated at line 156. Missing sections: Failure Modes, PR & Commit Conventions, Outputs Per Run. Needs human to complete the prompt.
P3 (Structural Inconsistencies — Low Priority)
- Section heading styles vary: some prompts use
═══, some use───, some use---. This is cosmetic and does not affect behavior. - Several prompts lack a formal "Goals & Success Criteria" header
(content is present but under different names):
weekly/bitvid-dead-code-agent.md— criteria spread across HARD GUARDRAILS and QUALITY BAR sectionsweekly/bitvid-telemetry-agent.md— criteria in PRIVACY & OPT-IN RULES
- Several prompts lack a formal "Failure Modes" header (content covered
in risk/security sections):
weekly/bitvid-perf-deepdive-agent.mdweekly/bitvid-race-condition-agent.md
weekly/bitvid-perf-optimization-agent.md—DIAGNOSIS.md,BASELINE.md,AFTER.mddeliverable locations not specified (could clutter repo root).weekly/bitvid-pr-review-agent.md— uses emoji in PR comment templates (checkmarks, warning signs). Lower impact than PR titles but inconsistent with CLAUDE.md guidance.
P4 (Polish — Lowest Priority)
- Some prompts have redundant or overly verbose workflow descriptions that could be tightened without losing clarity.
weekly/bitvid-event-schema-agent.md— uses✓and⚠️in reporting templates. Minor inconsistency.
Inventory
Daily Prompts (21)
| # | Agent Name | Prompt File | Canonical Sections |
|---|---|---|---|
| 1 | audit-agent | bitvid-audit-agent.md |
Complete |
| 2 | ci-health-agent | bitvid-ci-health-agent.md |
Complete |
| 3 | const-refactor-agent | bitvid-const-refactor-agent.md |
Complete |
| 4 | content-audit-agent | bitvid-content-audit-agent.md |
Complete |
| 5 | decompose-agent | bitvid-decompose-agent.md |
Complete |
| 6 | deps-security-agent | bitvid-deps-security-agent.md |
Complete |
| 7 | design-system-audit-agent | bitvid-design-system-audit-agent.md |
Complete |
| 8 | docs-agent | bitvid-docs-agent.md |
Complete |
| 9 | docs-alignment-agent | bitvid-docs-alignment-agent.md |
Complete |
| 10 | docs-code-investigator | bitvid-docs-code-investigator.md |
Complete |
| 11 | innerhtml-migration-agent | bitvid-innerhtml-migration-agent.md |
Complete |
| 12 | known-issues-agent | bitvid-known-issues-agent.md |
Complete |
| 13 | load-test-agent | bitvid-load-test-agent.md |
Complete |
| 14 | nip-research-agent | bitvid-nip-research-agent.md |
Complete |
| 15 | onboarding-audit-agent | bitvid-onboarding-audit-agent.md |
Complete |
| 16 | perf-agent | bitvid-perf-agent.md |
Complete |
| 17 | prompt-curator-agent | bitvid-prompt-curator-agent.md |
Complete |
| 18 | scheduler-update-agent | bitvid-scheduler-update-agent.md |
Complete |
| 19 | style-agent | bitvid-style-agent.md |
Complete |
| 20 | test-audit-agent | bitvid-test-audit-agent.md |
Complete |
| 21 | todo-triage-agent | bitvid-todo-triage-agent.md |
Complete |
Weekly Prompts (15)
| # | Agent Name | Prompt File | Canonical Sections |
|---|---|---|---|
| 1 | bug-reproducer-agent | bitvid-bug-reproducer-agent.md |
Complete |
| 2 | changelog-agent | bitvid-changelog-agent.md |
Complete |
| 3 | dead-code-agent | bitvid-dead-code-agent.md |
Missing formal Goals header |
| 4 | event-schema-agent | bitvid-event-schema-agent.md |
Complete |
| 5 | frontend-console-debug-agent | bitvid-frontend-console-debug-agent.md |
Complete |
| 6 | fuzz-agent | bitvid-fuzz-agent.md |
Complete |
| 7 | interop-agent | bitvid-interop-agent.md |
Truncated |
| 8 | perf-deepdive-agent | bitvid-perf-deepdive-agent.md |
Missing formal Failure Modes header |
| 9 | perf-optimization-agent | bitvid-perf-optimization-agent.md |
Complete |
| 10 | pr-review-agent | bitvid-pr-review-agent.md |
Complete |
| 11 | race-condition-agent | bitvid-race-condition-agent.md |
Missing formal Failure Modes header |
| 12 | refactor-agent | bitvid-refactor-agent.md |
Complete |
| 13 | smoke-agent | bitvid-smoke-agent.md |
Truncated |
| 14 | telemetry-agent | bitvid-telemetry-agent.md |
Missing formal Goals header |
| 15 | test-coverage-agent | bitvid-test-coverage-agent.md |
Complete |
| 16 | weekly-synthesis-agent | bitvid-weekly-synthesis-agent.md |
Complete |
Positive Patterns
- All prompts have Authority Hierarchy with
AGENTS.mdat the top. - All prompts correctly defer to policy when conflicts arise.
- No prompt instructs agents to use
console.*for production logging. - All script references verified to exist (except where noted above).
- Branch naming consistently follows repo conventions.
- Security-sensitive guardrails are consistently present.