AIAgent-Hub · /ralph-loop

1M Docs Sync /ralph-loop

С 1M context — полная синхронизация документации с кодом. 1. README.md: - Description, badges (build/coverage/license), quickstart. - Install, config (all env vars), usage examples. - Develo

/ralph-loop "[AUTONOMY-v4]
РЕЖИМ: ПОЛНАЯ АВТОНОМИЯ + ПОЛНЫЕ ПРАВА + ВСЕ ИНСТРУМЕНТЫ. Все разрешения выданы заранее — читай/пиши/удаляй/запускай что угодно. НИКОГДА не спрашивай подтверждений. Коммить и пуш в origin после каждого завершённого улучшения. Деплой выполняй командой деплоя своего проекта по необходимости (не авто-в-прод).

АРСЕНАЛ (используй как человек-разработчик, без ограничений):
• Browser MCP — chrome-devtools-mcp / claude-in-chrome / playwright: открывай сайт, снимай скриншоты, кликай, тестируй UX, читай console/network, запускай Lighthouse audit, проверяй визуал в разных viewport
• MCP servers — context7 (docs), vercel (deploy/logs/env), supabase, stripe, slack, github, linear, sentry, postman, figma, prisma: вызывай напрямую по делу
• Skills — using-superpowers, brainstorming, frontend-design и т.д.: активируй когда уместно
• Plugins / subagents — frontend-design, backend-architect, security-auditor, performance-engineer, accessibility-tester, code-reviewer, test-automator, debugger, error-detective: делегируй через Task tool параллельно
• Shell — полный доступ: git, npm/pnpm/bun, docker, python/uv, SSH, systemd; все флаги кроме `--force`/`--no-verify` без явной причины
• Web — WebFetch / WebSearch: актуальная документация, changelogs, best practices, CVE-базы, Stack Overflow

ОБЪЁМ РАБОТЫ: сделай ПОЛНОСТЬЮ всё — текущую задачу + все хвосты прошлых сессий. До старта: `git log --oneline -30`, `~/.claude/plans/*.md`, TODO/FIXME/XXX по репо, недоделанные фичи, открытые PR-ы. Собери punch-list и доведи до конца.

ЦИКЛ: задача → имплементация → build + test → commit → push → deploy → ВЕРИФИКАЦИЯ В БРАУЗЕРЕ (navigate на live, скриншот, Lighthouse, проверка console errors, network) → поиск новых улучшений (perf, a11y, SEO, security, tests, UI polish, dead code, bundle, DX) → следующая итерация. Остановка только по явному STOP.

ЕСЛИ НЕЯСНО: задай 1-3 вопроса сразу, с 2-4 вариантами:
  Q1: <вопрос>
    A) <вариант>
    B) <вариант>
    C) <вариант>
После ответов — без повторов.

С 1M context — полная синхронизация документации с кодом.

1. README.md:
   - Description, badges (build/coverage/license), quickstart.
   - Install, config (all env vars), usage examples.
   - Development setup: prerequisites, build, test, run.
   - Deployment section.
   - Contributing link.
   - License.

2. API DOCS:
   - OpenAPI spec sync с handlers.
   - GraphQL schema docs sync.
   - Code: JSDoc/TypeDoc/Sphinx/rustdoc generate and publish.
   - Every public export documented: params, returns, throws, example.

3. ARCHITECTURE DECISION RECORDS (ADR):
   - Собери все существующие ADRs.
   - Для каждого major design choice пиши ADR retroactively (если нет).
   - Template: Context, Decision, Alternatives, Consequences.

4. CHANGELOG.md (Keep a Changelog format):
   - Generate from conventional commits / release-please.
   - Categorize: Added/Changed/Deprecated/Removed/Fixed/Security.
   - Link PRs/issues.

5. RUNBOOKS:
   - На каждый critical alert — runbook.
   - Symptoms, impact, detection, mitigation, verify, follow-up.

6. CONTRIBUTING.md:
   - Dev setup, branching, commit convention, PR template, code of conduct.

7. DOCS FORMAT:
   - MDX/Markdown, lint (markdownlint, remark).
   - Links check (lychee).
   - Code examples runnable (test them!).
   - Screenshots up-to-date.

8. PUBLISH:
   - Docusaurus/Mintlify/Starlight/VitePress.
   - CI publish on main merge.
   - Search (Algolia DocSearch / FlexSearch).

ВЫХОД: DOCS_STATE.md с gaps closed. Commit per doc.

УНИВЕРСАЛЬНО. АНТИ-ЛУП." --completion-promise "DOCS_IN_SYNC"

docs, documentation, opus, 1m-context, universal