chore: vibe-coding
This commit is contained in:
parent
234b990ae2
commit
c787232cdc
|
|
@ -27,7 +27,7 @@ assets_folder: assets/beyond-vibe-coding/
|
||||||
|
|
||||||
# Brief
|
# Brief
|
||||||
|
|
||||||
See [brief.md](assets/beyond-vibe-coding/brief.md) for complete strategic context, target reader analysis, content requirements, and success criteria.
|
See [brief.md](assets/beyond-vibe-coding/brief.md)
|
||||||
|
|
||||||
**Quick Summary:**
|
**Quick Summary:**
|
||||||
- **Goal:** Fight "AI is for juniors" stigma with data-backed professional methodologies survey
|
- **Goal:** Fight "AI is for juniors" stigma with data-backed professional methodologies survey
|
||||||
|
|
@ -39,120 +39,137 @@ See [brief.md](assets/beyond-vibe-coding/brief.md) for complete strategic contex
|
||||||
|
|
||||||
# Outline
|
# Outline
|
||||||
|
|
||||||
See [outline.md](assets/beyond-vibe-coding/outline.md) for complete article structure.
|
See [outline.md](assets/beyond-vibe-coding/outline.md)
|
||||||
|
|
||||||
**Tone:** "Here's what exists and here's what I actually do" — landscape survey through practitioner's lens, not prescriptive guide
|
**Tone:** "Here's what exists and here's what I actually do" — landscape survey through practitioner's lens, not prescriptive guide
|
||||||
|
|
||||||
**Structure:**
|
|
||||||
- Introduction (400w) — Hook with vibe coding, establish legitimacy question
|
|
||||||
- 6 Methodology sections (400-500w each) — Credentials block, description, Henry's experience (integrated naturally)
|
|
||||||
- Conclusion (450w) — Landscape overview, legitimacy validation with stats, what I use, community invitation
|
|
||||||
|
|
||||||
**Total:** ~2,800 words
|
|
||||||
**Code examples:** 3 (CLAUDE.md spec, .claude/settings.json, TDD test)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Validation Status
|
# Validation Results
|
||||||
|
|
||||||
**Validated:** 2026-01-23
|
**Validated:** 2026-01-23
|
||||||
**Validator:** @validator
|
**Validator:** @validator
|
||||||
**Verdict:** REVISE → COMPLETE ✅
|
**Verdict:** PASS (after revisions)
|
||||||
|
|
||||||
See [validation-results.md](assets/beyond-vibe-coding/validation-results.md) for complete validation report.
|
See [validation-results.md](assets/beyond-vibe-coding/validation-results.md)
|
||||||
|
|
||||||
**Summary:**
|
**Summary:**
|
||||||
- ✅ **4 claims fully verified:** Senior/junior AI usage, 76% adoption, 27% bans, Ralph Loop virality
|
- 4 claims fully verified: Senior/junior AI usage, 76% adoption, 27% bans, Ralph Loop virality
|
||||||
- ✅ **Security vulnerabilities claim updated:** Added source citations [1][2][3]
|
- Security vulnerabilities claim updated with source citations
|
||||||
- ✅ **Removed false claims:** "359x growth" for SDD, "90% Fortune 100 Copilot adoption"
|
- Removed false claims: "359x growth" for SDD, "90% Fortune 100 Copilot adoption"
|
||||||
- ✅ **Minor stat correction:** "33%" → "about a third" for senior developers
|
- Minor stat correction: "33%" → "about a third"
|
||||||
|
|
||||||
**Revisions Applied by @architect:**
|
|
||||||
1. Removed Claim 4 (90% Fortune 100) from Conclusion section
|
|
||||||
2. Removed Claim 6 (359x growth) from Spec-Driven credentials, replaced with qualitative description
|
|
||||||
3. Added source citations for Claim 3 (security vulnerabilities): Georgetown CSET, Veracode, industry reports
|
|
||||||
4. Updated Claim 1 to "about a third" instead of "33%" in Introduction and Conclusion
|
|
||||||
|
|
||||||
**Next Step:** Ready for @writer to create Draft
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Assets Index
|
# Text
|
||||||
|
|
||||||
All working files for this article:
|
**Format:** 3-part series for dev.to
|
||||||
|
|
||||||
## Core Files
|
| Part | File | Title | Status |
|
||||||
|
|------|------|-------|--------|
|
||||||
|
| 1 | [text-p1.md](assets/beyond-vibe-coding/text-p1.md) | What Is Vibe Coding in 2026? One Year From Karpathy's Tweet | **Published** [dev.to](https://dev.to/h1gbosn/what-is-vibe-coding-in-2026-one-year-from-karpathys-tweet-5f43) |
|
||||||
|
| 2 | [text-p2.md](assets/beyond-vibe-coding/text-p2.md) | AI Pair Programming vs Agentic Coding | Ready |
|
||||||
|
| 3 | [text-p3.md](assets/beyond-vibe-coding/text-p3.md) | Human-in-the-Loop + TDD + AI | Ready |
|
||||||
|
|
||||||
| File | Purpose | Status |
|
**Reference:** [text.md](assets/beyond-vibe-coding/text.md) — original monolithic version before split
|
||||||
|------|---------|--------|
|
|
||||||
| [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 |
|
|
||||||
| [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 |
|
|
||||||
| [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
|
**Russian version:** [text-rus.md](assets/beyond-vibe-coding/text-rus.md)
|
||||||
|
|
||||||
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 |
|
|
||||||
|------|---------|
|
|
||||||
| [perplexity-chats/AI-Assisted Development_...](research/perplexity-chats/) | Original Perplexity research on terminology |
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# TODO: Part 4 (Potential Future Addition)
|
# SEO Optimization
|
||||||
|
|
||||||
Consider adding a fourth part to the series covering additional methodologies:
|
See [seo-metadata.md](assets/beyond-vibe-coding/seo-metadata.md) (pending completion)
|
||||||
|
|
||||||
| Methodology | Description | Status |
|
**Strategy (from @seo research):**
|
||||||
|-------------|-------------|--------|
|
|
||||||
| 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:
|
| Keyword | Volume | Notes |
|
||||||
- Architecture-First — enterprise/complex systems angle
|
|---------|--------|-------|
|
||||||
- Prompt-Driven — bridges gap between vibe coding and spec-driven
|
| vibe coding | 90,500 | Primary umbrella |
|
||||||
- Copy-pasting — the "default" many developers start with, important baseline
|
| what is vibe coding | 40,500 | Part 1 hook |
|
||||||
|
| spec driven development | 1,300 | Explosive growth |
|
||||||
|
| ai pair programming | 720 | Part 2 target |
|
||||||
|
| human in the loop ai | 880 | Part 3 target |
|
||||||
|
|
||||||
**Next steps:**
|
**Publication timing:** Part 1 on Feb 2, 2026 — exact 1-year anniversary of Karpathy's tweet.
|
||||||
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
|
|
||||||
|
# Image Specs
|
||||||
|
|
||||||
|
See [images/comic/cdn-urls.md](assets/beyond-vibe-coding/images/comic/cdn-urls.md)
|
||||||
|
|
||||||
|
**Status:** 8 comics + 2 infographics uploaded to CDN
|
||||||
|
|
||||||
|
| Type | Count | Location |
|
||||||
|
|------|-------|----------|
|
||||||
|
| Comics | 8 | images/comic/ |
|
||||||
|
| Infographics | 2 | images/infographic/ |
|
||||||
|
| Hero | 1 | images/hero-image.jpeg |
|
||||||
|
|
||||||
|
**Pending:** robots-flesh-bag-comic (HITL section)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# Review Chat
|
||||||
|
|
||||||
|
## 2026-02-02 @user + @editor — Part 1 Publication
|
||||||
|
|
||||||
|
**Published:** https://dev.to/h1gbosn/what-is-vibe-coding-in-2026-one-year-from-karpathys-tweet-5f43
|
||||||
|
|
||||||
|
**Human edits before publication:**
|
||||||
|
- Removed H1 title (dev.to handles separately)
|
||||||
|
- "started it all" → "started it" (more measured)
|
||||||
|
- Removed "(or 'vibecoding' as some write it)"
|
||||||
|
- Added infographic: "Vibe Coding DO and DON'T"
|
||||||
|
|
||||||
|
**Voice concern:** Article became more formal after SEO optimization. Need to restore Henry's personal voice in Parts 2-3.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Activity Log
|
# Activity Log
|
||||||
|
|
||||||
See [log-chat.md](assets/beyond-vibe-coding/log-chat.md)
|
See [log-chat.md](assets/beyond-vibe-coding/log-chat.md) for complete history.
|
||||||
|
|
||||||
**Latest:** @writer completed draft (2026-01-24). 2,650 words, 8 image placeholders for @image agent. No code snippets per user request.
|
**Key milestones:**
|
||||||
|
|
||||||
|
| Date | Agent | Action |
|
||||||
|
|------|-------|--------|
|
||||||
|
| 2026-01-22 | @strategist | Initial setup, research, interview |
|
||||||
|
| 2026-01-22 | @strategist | Keyword research, Brief creation |
|
||||||
|
| 2026-01-23 | @strategist | Brief refinements (impostor syndrome angle) |
|
||||||
|
| 2026-01-23 | @architect | Outline creation |
|
||||||
|
| 2026-01-23 | @validator | Fact-checking, removed false claims |
|
||||||
|
| 2026-01-24 | @writer | Draft creation (text.md) |
|
||||||
|
| 2026-01-31 | @seo | Series split (3 parts), keyword optimization |
|
||||||
|
| 2026-02-01 | @writer | Split into text-p1/p2/p3.md, expanded credentials |
|
||||||
|
| 2026-02-02 | @user | Part 1 published on dev.to |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# TODO: Part 4 (Future)
|
||||||
|
|
||||||
|
Consider adding a fourth part 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 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# Research Files
|
||||||
|
|
||||||
|
| File | Purpose |
|
||||||
|
|------|---------|
|
||||||
|
| [interview.md](assets/beyond-vibe-coding/interview.md) | Oleg's practitioner insights — source for Henry's voice |
|
||||||
|
| [ai-usage-statistics.md](assets/beyond-vibe-coding/ai-usage-statistics.md) | Statistical research for claims |
|
||||||
|
| [ai-adoption-statistics.md](assets/beyond-vibe-coding/ai-adoption-statistics.md) | LaTeX-formatted stats for infographics |
|
||||||
|
| [research-index.md](assets/beyond-vibe-coding/research-index.md) | Source verification index |
|
||||||
|
|
||||||
|
**Methodology specs:**
|
||||||
|
- [spec-driven-dev.md](assets/beyond-vibe-coding/spec-driven-dev.md)
|
||||||
|
- [agentic-coding.md](assets/beyond-vibe-coding/agentic-coding.md)
|
||||||
|
- [ai-pair-programming.md](assets/beyond-vibe-coding/ai-pair-programming.md)
|
||||||
|
- [ai-aided-test-first.md](assets/beyond-vibe-coding/ai-aided-test-first.md)
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue