Skip to content

Commit e0a8fda

Browse files
fix: resolve markdown linting issues in claude-code-feature-dev-comparison.md
- Add language specifiers (text) to all code blocks (MD040) - Convert emphasis-as-heading to proper headings for agents (MD036) - Remove empty code block Co-authored-by: Gregg Coppen <[email protected]>
1 parent 98ea2db commit e0a8fda

File tree

1 file changed

+10
-12
lines changed

1 file changed

+10
-12
lines changed

docs/research/codebase-context/claude-code-feature-dev-comparison.md

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ The Claude Code feature-dev plugin implements a battle-tested 7-phase workflow t
5454

5555
**Key Pattern:** Agent-based parallel discovery + explicit file reading
5656

57-
**Agent: code-explorer**
57+
### Agent: code-explorer
5858

5959
- **Tools:** Glob, Grep, LS, Read, NotebookRead, WebFetch, TodoWrite, WebSearch
6060
- **Model:** Sonnet
@@ -107,7 +107,7 @@ The Claude Code feature-dev plugin implements a battle-tested 7-phase workflow t
107107

108108
**Key Pattern:** Options with trade-offs + recommendation, not just one solution
109109

110-
**Agent: code-architect**
110+
### Agent: code-architect
111111

112112
- **Tools:** Glob, Grep, LS, Read, NotebookRead, WebFetch, TodoWrite, WebSearch
113113
- **Model:** Sonnet
@@ -160,7 +160,7 @@ The Claude Code feature-dev plugin implements a battle-tested 7-phase workflow t
160160

161161
**Key Pattern:** Parallel multi-focus review + user decision on fixes
162162

163-
**Agent: code-reviewer**
163+
### Agent: code-reviewer
164164

165165
- **Tools:** Glob, Grep, LS, Read, NotebookRead, WebFetch, TodoWrite, WebSearch
166166
- **Model:** Sonnet
@@ -395,7 +395,7 @@ The Claude Code feature-dev plugin implements a battle-tested 7-phase workflow t
395395

396396
### Claude Code Flow
397397

398-
```
398+
```text
399399
1. Discovery → Understand feature request
400400
401401
2. Codebase → Launch 2-3 code-explorer agents
@@ -423,7 +423,7 @@ The Claude Code feature-dev plugin implements a battle-tested 7-phase workflow t
423423

424424
### Our Current Flow
425425

426-
```
426+
```text
427427
1. generate- → Comprehensive codebase analysis
428428
codebase-context Generate analysis document
429429
@@ -468,7 +468,7 @@ The AI should adapt its questions based on the prompt...
468468

469469
**Recommended Change:**
470470

471-
```markdown
471+
```text
472472
## Phase 1: Initial Understanding
473473
- Receive feature request
474474
- Clarify if unclear
@@ -614,8 +614,6 @@ User Login:
614614
5. Database query → models/User.ts:89
615615
6. JWT token generation → utils/jwt.ts:12
616616
7. Response with token → controllers/AuthController.ts:52
617-
618-
```
619617
```
620618
621619
**Rationale:** Makes codebase context more action-oriented, similar to code-explorer agent.
@@ -626,7 +624,7 @@ User Login:
626624
627625
**Current State:**
628626
629-
```markdown
627+
```text
630628
## Process
631629
...
632630
4. Assess current state (codebase review)
@@ -636,7 +634,7 @@ User Login:
636634

637635
**Recommended Change:**
638636

639-
```markdown
637+
```text
640638
## Process
641639
...
642640
4. **Review Architecture Decision:**
@@ -660,7 +658,7 @@ User Login:
660658

661659
Add checkpoint markers:
662660

663-
```markdown
661+
```text
664662
## Checkpoints
665663
666664
This prompt has the following user interaction checkpoints:
@@ -712,7 +710,7 @@ Create `docs/workflow.md`:
712710

713711
## Updated Workflow Diagram
714712

715-
```
713+
```text
716714
┌─────────────────────────────────────────────────────────────┐
717715
│ SPEC-DRIVEN DEVELOPMENT │
718716
└─────────────────────────────────────────────────────────────┘

0 commit comments

Comments
 (0)