Florian BRUNIAUX
|
d1182af4cf
|
docs: v3.27.1 — fact-check corrections, grepai docs, RTK overhaul
Fact-check (README positioning):
- Template count: 120/123 → 108 (ground truth recount)
- Ratio: 14× → 24× (19,000 ÷ 784 = 24.2×)
- everything-cc stars: 31.9k → 45k+ (verified Feb 15)
- Commands count: 20 → 23, hooks: 30 → 31
Added:
- Grepai MCP documentation (semantic search, call graphs)
- 3 hook templates (rtk-baseline, session-summary, session-summary-config)
- 2 resource evaluations (system-prompts update, qmd token savings)
Changed:
- RTK documentation overhaul (v0.7.0 → v0.16.0, rtk-ai org)
- Exports deprecated (kimi.pdf, notebooklm.pdf → deprecated/)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
2026-02-15 18:41:45 +01:00 |
|
Florian BRUNIAUX
|
fb339b8575
|
docs: update RTK evaluation (v0.2.0 → v0.7.0)
BREAKING UPDATE: All gaps from initial evaluation resolved upstream.
## Version Evolution
- Initial eval: v0.2.0 (2026-01-28, score 4/5)
- Updated eval: v0.7.0 (2026-02-01, score 4.5/5)
- Development: 5 major releases in 9 days
## Critical Changes Resolved
✅ pnpm support (v0.6.0) - was MISSING
✅ npm/vitest support (v0.6.0) - was MISSING
✅ Git arg parsing (v0.7.0) - was BROKEN
✅ grep functionality (v0.7.0) - was BROKEN
✅ ls efficiency (v0.7.0+) - was BROKEN (-274% worse)
✅ Analytics (v0.4.0) - rtk gain temporal audit
✅ Opportunity scanner (v0.7.0) - rtk discover
✅ GitHub CLI (v0.6.0) - full gh support
✅ Cargo commands (v0.6.0) - build/test/clippy
✅ Auto-rewrite hook (v0.7.0) - PreToolUse integration
## Score Changes
| Criterion | v0.2.0 | v0.7.0 | Change |
|-----------|--------|--------|--------|
| Accuracy & Reliability | 3 | 4 | +1 |
| Depth & Comprehensiveness | 4 | 5 | +1 |
| Practical Value | 5 | 5 | 0 |
| Originality & Uniqueness | 5 | 5 | 0 |
| Production Readiness | 3 | 4 | +1 |
| Community Validation | 2 | 3 | +1 |
| **TOTAL** | 3.90 | 4.33 | +0.43 |
Rounded: 4/5 → **4.5/5**
## Community Growth
- Stars: 8 → 17 (+113%)
- Forks: 0 → 2 (+200%)
- PRs merged: 0 → 10+ (community contributions)
- Contributors: 1 → 2+
## Architecture Maturity
- 24 command modules (was 12)
- 9 filtering strategies (50-99% reduction)
- SQLite token tracking (~/.local/share/rtk/history.db)
- Configuration system (~/.config/rtk/config.toml)
## Recommendation Update
- OLD: "GOOD (4/5) - git-only, bugs, experimental"
- NEW: "EXCELLENT (4.5/5) - production-ready, full stack"
## Fork Status
- Fork (FlorianBruniaux) contributed 10+ PRs to upstream
- All features merged → fork no longer needed
- Recommendation: Use upstream v0.7.0 directly
## Impact
- Token reduction: 72.6% (git) → 89.4% (full stack)
- Command coverage: 40% → 85% (dev sessions)
- Maturity: experimental → production-ready (early adopters)
File changes: 633 lines (+69), 405 insertions, 335 deletions (major rewrite)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
2026-02-01 23:07:12 +01:00 |
|
Florian BRUNIAUX
|
fdee3305c5
|
docs: RTK documentation update - upstream + fork integration
- Update guide/ultimate-guide.md: RTK section (l.11084-11174)
- Two repositories: upstream (stable) + fork (extended features)
- Fork features: vitest, pnpm, prisma, gain, discover
- Bug fixes documented (grep/ls fixed in fork)
- Installation options: cargo, fork, binary
- Add guide/third-party-tools.md: RTK card (l.86)
- Comparison upstream vs fork
- Token savings: 70-90% depending on stack
- Cross-reference to ultimate-guide Section 9
- Update machine-readable/reference.yaml:
- rtk_upstream + rtk_fork_extended (two repos)
- third_party_tools_rtk entry added
- Line numbers updated
- Update docs/resource-evaluations/rtk-evaluation.md:
- UPDATE 2026-02-01 section with fork comparison
- Fork features table (JS/TS stack support)
- Installation instructions for fork
Total: 4 files, ~320 lines modified
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
2026-02-01 22:20:43 +01:00 |
|
Florian BRUNIAUX
|
c28161dca8
|
docs: enrich RTK evaluation with T3 Stack production testing
Real-World Testing Results (Méthode Aristote - T3 Stack):
- Project: Next.js 15 + tRPC + Prisma + pnpm
- Commands tested: 12 (git, pnpm, Vitest, TypeScript, Prisma)
- Git workflows validated: 85.6% avg reduction (up from 72.6%)
Critical Bug Discovered:
- git argument parsing broken (`--oneline`, `--graph` blocked)
- Workaround: `rtk git log -- -20` (works)
- Impact: CRITICAL - affects ALL git users
Modern Stack Gaps Identified:
- pnpm support MISSING (80-90% reduction possible, CRITICAL impact)
- Vitest support MISSING (90% reduction possible, HIGH impact)
- TypeScript support MISSING (70% reduction possible, MEDIUM impact)
ROI Analysis:
- Current v0.2.0: 40% command coverage, 55% token reduction
- Proposed v0.3.0 (pnpm + Vitest): 85% coverage, 80% reduction
- Dev effort: 1 week (7 days)
New Deliverables:
- Benchmark script: examples/scripts/rtk-benchmark.sh (reproductible tests)
- Test results: claudedocs/rtk-test-results-aristote.md (53KB, gitignored)
- Updated PR proposals: claudedocs/rtk-pr-proposals.md (P0-P2 ranking)
- GitHub issues: claudedocs/rtk-github-issue-template.md (ready for upstream)
Updated Evaluation:
- Score: Still 4/5 (GOOD) but clearer path to 5/5 (CRITICAL)
- Blockers: git args bug + pnpm/Vitest gaps
- Strength: 85.6% git reduction validated on production codebase
Full report: claudedocs/rtk-test-results-aristote.md (23K detailed analysis)
|
2026-01-28 14:01:37 +01:00 |
|
Florian BRUNIAUX
|
1000cb6e85
|
docs: add RTK integration templates and evaluation
- Evaluation: docs/resource-evaluations/rtk-evaluation.md (4/5 score, comprehensive benchmarks)
- CLAUDE.md template: examples/claude-md/rtk-optimized.md (manual usage instructions)
- Skill template: examples/skills/rtk-optimizer/SKILL.md (auto-suggestion)
- Hook template: examples/hooks/bash/rtk-auto-wrapper.sh (PreToolUse auto-wrapper)
- PR proposals: claudedocs/rtk-pr-proposals.md (7 upstream improvements)
These templates enable 3 RTK integration strategies referenced in guide:10478
|
2026-01-28 13:03:10 +01:00 |
|