Skip to content

Commit 8f5f6a5

Browse files
committed
fix: resolve markdownlint errors in ASLCD grand vision doc
1 parent 5293e02 commit 8f5f6a5

1 file changed

Lines changed: 20 additions & 14 deletions

File tree

.documentation/drafts/01-grand-vision-aslcd-toolkit.md

Lines changed: 20 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Today's AI coding tools suffer from fundamental limitations:
5252

5353
Traditional development treats code as king:
5454

55-
```
55+
```text
5656
Requirements → Design → Code → Test → Deploy
5757
5858
(Source of truth)
@@ -64,7 +64,7 @@ This creates an inevitable gap between intent and implementation. Documentation
6464

6565
ASLCD inverts this model:
6666

67-
```
67+
```text
6868
Constitution → Specification → Plan → Tasks → Code
6969
↑ ↑ |
7070
| (Source of truth) |
@@ -86,7 +86,7 @@ In 3-5 years, a development team using ASLCD will experience:
8686

8787
Every change—from major feature to bug fix—begins with a specification appropriate to its scope. AI agents understand context through specifications, not by reading thousands of lines of code.
8888

89-
```
89+
```text
9090
Developer: "Add password reset functionality"
9191
9292
AI Agent:
@@ -106,7 +106,7 @@ The constitution is not a static document written once. It evolves through:
106106
- **Evolution**: Amended based on real-world learnings
107107
- **Inheritance**: Organization-level principles flow to projects
108108

109-
```
109+
```text
110110
Organization Constitution
111111
112112
├── Project A Constitution (extends)
@@ -123,7 +123,7 @@ Instead of losing institutional knowledge when developers leave or projects age:
123123
- **Learnings**: Constitution evolves based on real outcomes
124124
- **History**: Git preserves everything; library preserves wisdom
125125

126-
```
126+
```text
127127
Feature Complete
128128
129129
├── Code merged (in git forever)
@@ -155,7 +155,7 @@ The system detects scope and suggests appropriate rigor.
155155
- **Large teams**: Landmarks prevent "merge roulette" and establish clear ownership
156156
- **Enterprise**: Inherited constitutions ensure consistency across hundreds of repos
157157

158-
```
158+
```text
159159
Process Overhead
160160
161161
@@ -179,7 +179,8 @@ Anything above the appropriate line is bureaucracy. Anything below is recklessne
179179
ASLCD works for codebases of any age:
180180

181181
**Greenfield (New Projects):**
182-
```
182+
183+
```text
183184
Day 1: Minimal constitution (security, testing, dependencies)
184185
185186
Week 4: Add patterns as they emerge
@@ -192,7 +193,8 @@ Year 1+: Mature constitution, rich pattern library
192193
The constitution **grows with the project**. Start with 10 principles, not 100.
193194

194195
**Brownfield (Legacy Systems):**
195-
```
196+
197+
```text
196198
Existing Code → /speckit.discover-constitution → Extracted Patterns
197199
198200
Draft Constitution
@@ -203,6 +205,7 @@ Existing Code → /speckit.discover-constitution → Extracted Patterns
203205
```
204206

205207
Constitution discovery analyzes:
208+
206209
- File structure and naming conventions
207210
- Import patterns and dependency graphs
208211
- Error handling approaches
@@ -215,7 +218,7 @@ This means a 15-year-old legacy system can adopt ASLCD **without rewriting anyth
215218

216219
Progress through the lifecycle requires explicit checkpoints:
217220

218-
```
221+
```text
219222
Spec Written ──PR──► Spec Approved ──PR──► Plan Approved ──PR──► Code Merged
220223
│ │ │
221224
▼ ▼ ▼
@@ -244,7 +247,7 @@ Constitution compliance is not a one-time check:
244247
- **At PR Review**: Does this change violate anything?
245248
- **At Audit**: Has the codebase drifted?
246249

247-
```
250+
```text
248251
┌─────────────────────────────────────────────────────┐
249252
│ COMPLIANCE THROUGHOUT │
250253
├─────────────────────────────────────────────────────┤
@@ -265,7 +268,7 @@ Large codebases create "context chaos" for AI—too much information leads to th
265268

266269
ASLCD solves this through **Right-Sized Context Delivery**:
267270

268-
```
271+
```text
269272
┌─────────────────────────────────────────────────────────────┐
270273
│ CONTEXT SCALING │
271274
├─────────────────────────────────────────────────────────────┤
@@ -298,7 +301,7 @@ This means a 2-million-line codebase gets the **same AI effectiveness** as a 2,0
298301

299302
After features ship, the system learns:
300303

301-
```
304+
```text
302305
Feature Shipped
303306
304307
├── Did implementation match spec? (accuracy)
@@ -366,7 +369,7 @@ The constitution is not bureaucracy. It's the project's conscience:
366369

367370
Process overhead should match task complexity **and team context**:
368371

369-
```
372+
```text
370373
Process Overhead
371374
372375
│ Enterprise
@@ -380,6 +383,7 @@ Process Overhead
380383
```
381384

382385
The "appropriate rigor line" shifts based on:
386+
383387
- Team size and distribution
384388
- Project criticality (hobby vs. financial system)
385389
- Regulatory requirements
@@ -468,7 +472,7 @@ AI assists at every stage. Humans decide at gates.
468472

469473
**Constitution Inheritance Model:**
470474

471-
```
475+
```text
472476
┌─────────────────────────────────────────────────────────────┐
473477
│ ENTERPRISE SCALING │
474478
├─────────────────────────────────────────────────────────────┤
@@ -492,6 +496,7 @@ AI assists at every stage. Humans decide at gates.
492496
```
493497

494498
This enables:
499+
495500
- Consistent security practices across 100+ repositories
496501
- Division-specific patterns that don't pollute other teams
497502
- Individual project flexibility within organizational guardrails
@@ -591,6 +596,7 @@ This is the future we're building:
591596
- **AI-accelerated**: Agents that work within guardrails
592597

593598
**The same principles serve:**
599+
594600
- The solo developer shipping a weekend project
595601
- The startup racing to product-market fit
596602
- The enterprise maintaining critical infrastructure

0 commit comments

Comments
 (0)