Architecture audit + Claude Code workflow review для production SaaS на Next.js / tRPC / Prisma

Вітаю, Тарасе!

Ваш стек — Next.js, React, Prisma ORM, TypeScript, PostgreSQL — це саме те, з чим я щодня працюю. У портфоліо є проект Ukrainian Cuisine на цьому стеку з нуля до деплою на Vercel.

Що зроблю в рамках аудиту:

Findings register: задокументую всі знахідки у форматі F-NN з severity, effort, file refs, root cause та готовим Claude Code prompt для виправлення.

ADRs: опишу non-obvious архітектурні рішення у вашому форматі ADR-NNN з продовженням нумерації.
…
CLAUDE.md updates: конкретні правила та anti-patterns саме для вашої кодової бази.

Refined 4–8 week plan: у форматі NOW.md / ROADMAP.md з розбивкою по годинах і revenue terms.

Claude Code workflow notes: де Claude Code генерує tech debt у вашому репо і як це виправити через slash commands та hooks.

Бонус: 1–2 SPEC-NN handoff docs для наступних модулів.

Claude Code використовую щодня — розумію контекст зсередини.

Вітаю!

Це дуже цікавий запит, особливо тому, що вам потрібен не generic audit, а audit, який реально ляже в існуючу documentation/code workflow і буде корисний для Claude Code після рев’ю.

Я full-stack JavaScript/TypeScript developer з досвідом React / Next.js / Node.js, Prisma, SaaS-проєктів, AI workflows та production codebases. Також активно працюю з AI-assisted development підходом: specs → implementation → verification → docs/handoff, де AI не просто “генерує код”, а працює в межах чітких правил, контексту та документації.

Один релевантний проєкт: PrecisAI — full-stack AI/SaaS platform на Next.js, Supabase/Postgres, Vercel та кількох LLM API. Найскладнішою частиною була не сама інтеграція AI, а контроль context flow, agentic workflow, media monitoring pipeline, debugging AI outputs і зменшення tech debt, коли багато рішень швидко генеруються AI. Зараз я б ще раніше формалізував specs, ADRs, agent rules і verification checklist, щоб AI не створював приховані architectural inconsistencies.

Мій actual AI/Claude-style loop:
…
1. Спочатку читаю код і документацію, не починаю з генерації.
2. Формую короткий intent/spec: що змінюємо, що не чіпаємо, які constraints.
3. Даю AI вузький execution scope, а не “fix everything”.
4. Після виконання перевіряю diff, types, tests, edge cases, API contracts.
5. Якщо рішення non-obvious — фіксую в ADR/spec/doc, щоб наступні ітерації не ламали context.
6. Для великих змін — розбиваю на маленькі handoff prompts, які можна запускати окремо.

Що я б поставив під сумнів у вашому оголошенні: вимогу “усе має одразу бути придатним для Claude Code без переписування”. Я згоден з ціллю, але на практиці частину документації спочатку треба нормалізувати: прибрати ambiguity, дублікати, застарілі rules і conflicting instructions. Інакше Claude Code буде використовувати документацію як compass, але compass може показувати в різні боки.

Що я можу підготувати:

* findings.md у форматі F-NN з severity, effort, path:line, root cause, fix proposal та Claude Code handoff prompt;
* ADR-NNN для lock in / reverse рішень;
* точкові updates для CLAUDE.md саме під ваш codebase;
* 4–8 week plan у форматі NOW.md / ROADMAP.md;
* workflow notes: де Claude Code створює debt, які prompts/hooks/subagents/skills варто додати;
* 1–2 SPEC-NN handoff docs для майбутніх модулів.

Я не буду пропонувати перепис stack. Мій фокус — зрозуміти існуючу систему, знайти слабкі місця, зафіксувати рішення і зробити так, щоб Claude Code після аудиту працював точніше,

Привіт. Зацікавив проєкт: solo-продукт на Next.js/tRPC/Prisma, який пройшов 6 місяців у production з Claude Code як основною інженерною силою. Це формат, який потребує реальної інженерної емпатії, а не просто шаблонного аудиту.

Я 3.5 роки роблю комерційний фулстек на TypeScript, Next.js/Nuxt, NestJS, PostgreSQL. Працював над B2B e-commerce платформою (~40 моделей, складна доменна логіка) і продуктами на стику UX і архітектури. Активно використовую Claude Code щодня: будую структуру документації, розпис інваріантів, навігацію по контексту, щоб модель ефективно працювала всередині кодової бази, а не переписувала її.

Можу зробити аудит у форматі, який лягає в існуючу систему документації, з findings, рекомендаціями і concrete steps, придатними для Claude Code як compass. Готовий обговорити обсяг і пріоритети детально.

Ви так замелали текст англійськими словами, що могли вже на англійському заявку кинути. Аудит коду, без питань. Пишіть, оцінемо і зробимо.

Показати оригінал

Перекласти

Вітаю, Тарасе.

1. Solo: cyanship.com, SaaS соло на близькому стеку. Auth, Stripe billing, streaming AI чат, usage-based баланс. Складне: синхронізація Stripe webhook з internal balance під race conditions. Зараз би переніс AI квоти з Mongo в Redis з atomic decrement замість optimistic transactional update.

2. Claude Code loop:
– planning: задача плюс CLAUDE.md контекст, прошу 3 підходи з trade-offs, обираю один.
– spec: input, output, edge cases, acceptance в окремий .md, фіксую до коду.
– execution: атомарні commits по 30-90 хв, після кожного types плюс relevant tests.
– verification: якщо результат не сходиться зі spec, правлю spec, не накладаю патчі зверху.
…
3. Push back на bonus: 1-2 SPEC-NN docs всередині аудиту дають bias. Спочатку пріоритезація findings і рішення fix/refactor/leave, після цього специ пишуться під найважливіше, не під найзручніше. Я б виніс bonus окремим етапом після узгодження register.

Стек: Next.js, Prisma, Redis, TS daily. tRPC, Hono, Bun, BullMQ, Better-Auth, CASL не daily, робив на близьких аналогах, читаю код. Кажу як є.

Дайте read-only на 2-3 найбільш проблемні файли, поверну конкретні нотатки за 24 год.

Етапи:

1. Read-through кодбази, первинні findings, узгодження пріоритетів — 12 000 грн
2. Findings register, ADRs, CLAUDE.md updates — 12 000 грн
3. Refined 4-8 week plan, handoff документи — 6 000 грн

Доброго дня! Я уважно ознайомився з вашим проектом і готовий розпочати роботу. Гарантую якісне та своєчасне виконання.

Показати оригінал

Перекласти

я входжу до топ-10 розробників у категорії «Штучний інтелект і машинне навчання» серед ~2100 фахівців на платформі.
Гарантую:
- Швидке та якісне виконання завдання
- Чітке дотримання дедлайнів
- Регулярний зв'язок протягом усього процесу
Буду радий обговорити деталі вашого проекту у приватних повідомленнях.

Вітаю.Працюю з React/Node.js понад 9+ років.Готовий до співпраці.