From c67b9695b7739c2f0e372e141eb7e40d68902920 Mon Sep 17 00:00:00 2001 From: Oleg Proskurin Date: Sun, 1 Feb 2026 22:17:51 +0700 Subject: [PATCH] update by writer --- 3-drafting/beyond-vibe-coding.md | 60 +++++++++++++++++++-- assets/beyond-vibe-coding/log-chat.md | 41 ++++++++++++++ assets/beyond-vibe-coding/research-index.md | 34 +++++++++++- 3 files changed, 129 insertions(+), 6 deletions(-) diff --git a/3-drafting/beyond-vibe-coding.md b/3-drafting/beyond-vibe-coding.md index 43087af..8d93e43 100644 --- a/3-drafting/beyond-vibe-coding.md +++ b/3-drafting/beyond-vibe-coding.md @@ -79,18 +79,46 @@ See [validation-results.md](assets/beyond-vibe-coding/validation-results.md) for All working files for this article: +## Core Files + | File | Purpose | Status | |------|---------|--------| | [brief.md](assets/beyond-vibe-coding/brief.md) | Complete Brief: strategic context, target reader, requirements, success criteria | ✅ Complete | | [outline.md](assets/beyond-vibe-coding/outline.md) | Article structure with word budgets | ✅ Revised & Complete | -| [ai-usage-statistics.md](assets/beyond-vibe-coding/ai-usage-statistics.md) | Statistical research: AI adoption by seniority, company policies, security concerns | ✅ Complete | +| [text.md](assets/beyond-vibe-coding/text.md) | Article draft (English) | ✅ Draft complete | +| [text-rus.md](assets/beyond-vibe-coding/text-rus.md) | Article draft (Russian) | ✅ Complete | | [interview.md](assets/beyond-vibe-coding/interview.md) | Oleg's practitioner insights — source for Henry's voice | ✅ Complete | -| [research-index.md](assets/beyond-vibe-coding/research-index.md) | Methodology clusters, verified sources, interview questions | ✅ Complete | -| [validation-results.md](assets/beyond-vibe-coding/validation-results.md) | Fact-checking results for all statistical claims | ✅ Complete | -| [log-chat.md](assets/beyond-vibe-coding/log-chat.md) | Activity log and agent comments | ⏳ Needs update | -| [text.md](assets/beyond-vibe-coding/text.md) | Article draft | ✅ Draft complete | +| [log-chat.md](assets/beyond-vibe-coding/log-chat.md) | Activity log and agent comments | ⏳ Active | | [seo-metadata.md](assets/beyond-vibe-coding/seo-metadata.md) | SEO title, description, keywords | ⏳ Pending @seo | +## Methodology Specs + +Detailed research for each methodology — use for expanding credentials in text.md: + +| File | Methodology | Key Sources | +|------|-------------|-------------| +| [spec-driven-dev.md](assets/beyond-vibe-coding/spec-driven-dev.md) | Spec-Driven Development | GitHub Spec Kit, AWS Kiro, Tessl, Martin Fowler | +| [agentic-coding.md](assets/beyond-vibe-coding/agentic-coding.md) | Agentic Coding + Ralph Loop | arXiv papers, Geoffrey Huntley, Cursor 2.0, GitHub Copilot Agent Mode | +| [ai-pair-programming.md](assets/beyond-vibe-coding/ai-pair-programming.md) | AI Pair Programming | GitHub Copilot official, Microsoft Learn, Cursor, Windsurf | +| [ai-aided-test-first.md](assets/beyond-vibe-coding/ai-aided-test-first.md) | TDD + AI | Thoughtworks Radar, Kent Beck, DORA Report 2025, Builder.io | + +## Statistics & Research + +| File | Purpose | Status | +|------|---------|--------| +| [ai-usage-statistics.md](assets/beyond-vibe-coding/ai-usage-statistics.md) | Statistical research: AI adoption by seniority, company policies, security concerns | ✅ Complete | +| [ai-adoption-statistics.md](assets/beyond-vibe-coding/ai-adoption-statistics.md) | LaTeX-formatted statistics for infographics (2024-2026 data) | ✅ Complete | +| [research-index.md](assets/beyond-vibe-coding/research-index.md) | Methodology clusters, verified sources, interview questions | ⏳ Needs update | +| [validation-results.md](assets/beyond-vibe-coding/validation-results.md) | Fact-checking results for all statistical claims | ✅ Complete | + +## Images + +| Folder | Contents | Status | +|--------|----------|--------| +| [images/comic/](assets/beyond-vibe-coding/images/comic/) | 8 comic illustrations, uploaded to CDN | ✅ Ready | +| [images/infographic/](assets/beyond-vibe-coding/images/infographic/) | Infographics (based on ai-adoption-statistics.md) | ⏳ In progress | +| [images/comic/cdn-urls.md](assets/beyond-vibe-coding/images/comic/cdn-urls.md) | CDN URLs for all comic images | ✅ Complete | + ## External Research | File | Purpose | @@ -99,6 +127,28 @@ All working files for this article: --- +# TODO: Part 4 (Potential Future Addition) + +Consider adding a fourth part to the series covering additional methodologies: + +| Methodology | Description | Status | +|-------------|-------------|--------| +| Architecture-First AI Development | Design patterns and system architecture before AI implementation | ⏳ Needs research | +| Prompt-Driven Development | Structured prompt engineering as development methodology | ⏳ Needs research | +| Copy-pasting from AI chatbot | Manual workflow — baseline to compare other methods against | ⏳ Needs research | + +**Rationale:** These approaches represent common patterns not covered in Parts 1-3: +- Architecture-First — enterprise/complex systems angle +- Prompt-Driven — bridges gap between vibe coding and spec-driven +- Copy-pasting — the "default" many developers start with, important baseline + +**Next steps:** +1. Research each methodology for credentials and sources +2. Conduct interview with Oleg for Henry's perspective +3. Assess if volume/interest justifies a Part 4 + +--- + # Activity Log See [log-chat.md](assets/beyond-vibe-coding/log-chat.md) diff --git a/assets/beyond-vibe-coding/log-chat.md b/assets/beyond-vibe-coding/log-chat.md index f4bac46..0f59507 100644 --- a/assets/beyond-vibe-coding/log-chat.md +++ b/assets/beyond-vibe-coding/log-chat.md @@ -557,3 +557,44 @@ Rationale: --- +## 2026-02-01 @writer + +**Action:** Index updates per user request + +**Changes made:** + +1. **Updated main file** (`3-drafting/beyond-vibe-coding.md`): + - Restructured Assets Index with sections: Core Files, Methodology Specs, Statistics & Research, Images + - Added all 4 methodology spec files with key sources + - Added ai-adoption-statistics.md reference + - Added images folder reference with CDN URLs + - Added text-rus.md reference + - **Added TODO section for Part 4** (Architecture-First, Prompt-Driven, Copy-pasting) + +2. **Updated research-index.md**: + - Added Source Files section with all spec file references + - Added statistics files references + - Added TODO section for Part 4 methodologies research + +**Pending from log-chat:** + +| Task | Status | Notes | +|------|--------|-------| +| Part 4 TODO | ✅ Done | Added to main file + research-index | +| Spec files in index | ✅ Done | All 4 specs referenced | +| Expand credentials in text.md | ⏳ Pending | Needs discussion — significant work | +| Insert images | ⏳ Waiting | User said "позже" | + +**Question for @user:** +Расширение credentials в text.md ссылками из спек-файлов — это большая работа. Хочешь чтобы я сейчас это сделал, или сначала закончим с картинками и публикацией Part 1? + +**Files updated:** +- `3-drafting/beyond-vibe-coding.md` +- `assets/beyond-vibe-coding/research-index.md` +- `assets/beyond-vibe-coding/log-chat.md` (this entry) + +**Images status:** +8 comic images ready on CDN (see `images/comic/cdn-urls.md`). Waiting for user instructions on insertion. + +--- + diff --git a/assets/beyond-vibe-coding/research-index.md b/assets/beyond-vibe-coding/research-index.md index 7e51d8e..454cad9 100644 --- a/assets/beyond-vibe-coding/research-index.md +++ b/assets/beyond-vibe-coding/research-index.md @@ -2,9 +2,21 @@ Working file for methodology clustering and source verification. -## Source +## Source Files + +**Original research:** - `perplexity-terminology-research.md` — original Perplexity research (Jan 2025) +**Methodology Specs (detailed research per methodology):** +- [spec-driven-dev.md](spec-driven-dev.md) — GitHub Spec Kit, AWS Kiro, Tessl, Thoughtworks +- [agentic-coding.md](agentic-coding.md) — arXiv papers, Ralph Loop, Geoffrey Huntley, Cursor 2.0 +- [ai-pair-programming.md](ai-pair-programming.md) — GitHub Copilot official, Microsoft Learn, Cursor +- [ai-aided-test-first.md](ai-aided-test-first.md) — Thoughtworks Radar, Kent Beck, DORA Report 2025 + +**Statistics:** +- [ai-usage-statistics.md](ai-usage-statistics.md) — AI adoption by seniority, company policies, security (35+ sources) +- [ai-adoption-statistics.md](ai-adoption-statistics.md) — LaTeX-formatted data for infographics (2024-2026) + --- ## Methodology Selection @@ -174,3 +186,23 @@ Questions for Oleg to capture Henry's authentic voice: --- *Updated: 2026-01-22* + +--- + +## TODO: Part 4 Methodologies + +Potential additions for a fourth part of the series: + +| Methodology | Research Status | Notes | +|-------------|-----------------|-------| +| Architecture-First AI Development | ⏳ Not started | Enterprise/complex systems angle | +| Prompt-Driven Development | ⏳ Not started | Bridges vibe coding and spec-driven | +| Copy-pasting from AI chatbot | ⏳ Not started | Baseline methodology, most developers start here | + +**Research needed:** +- Source verification for each methodology +- Interview Oleg for Henry's perspective +- Keyword research for SEO value +- Assess if Part 4 justified by volume/interest + +See main file `3-drafting/beyond-vibe-coding.md` for strategic context.