Skip to content

Commit 8d57e72

Browse files
committed
fix: resolve markdownlint errors in 5 files
- quickstart.md: merge adjacent blockquotes (MD028) - AGENTS.md: add language to fenced code block (MD040), blank line before list (MD032) - FORK_DIVERGENCE.md: renumber ordered list items to be sequential (MD029) - spec-driven.md: add blank lines before lists (MD032) - personalize.md: add language to fenced code blocks (MD040)
1 parent 20d5d72 commit 8d57e72

5 files changed

Lines changed: 10 additions & 7 deletions

File tree

.documentation/quickstart.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This guide will help you get started with Spec-Driven Development using Spec Kit
44

55
> [!NOTE]
66
> All automation scripts now provide both Bash (`.sh`) and PowerShell (`.ps1`) variants. The `specify` CLI auto-selects based on OS unless you pass `--script sh|ps`.
7-
7+
>
88
> [!TIP]
99
> **Agent-Agnostic**: Spec Kit works identically with any of 17+ supported AI agents. The workflow below applies regardless of which agent you choose — canonical prompts live in `.documentation/commands/` and your agent gets thin shims that redirect there.
1010

AGENTS.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Spec Kit uses an **agnostic-by-default** architecture. All command prompts, scri
1616

1717
### File Layout
1818

19-
```
19+
```text
2020
.documentation/
2121
├── commands/ ← Canonical command prompts (agent-agnostic)
2222
│ ├── speckit.specify.md
@@ -40,6 +40,7 @@ Spec Kit uses an **agnostic-by-default** architecture. All command prompts, scri
4040
### Shim Behavior
4141

4242
Each platform shim:
43+
4344
1. Resolves the current git user (`git config user.name`, slug-normalized)
4445
2. Checks for a personalized override at `.documentation/{git-user}/commands/speckit.{cmd}.md`
4546
3. Falls back to the shared default at `.documentation/commands/speckit.{cmd}.md`

FORK_DIVERGENCE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,20 +43,20 @@ This document tracks how **Spec Kit Spark** has diverged from and absorbed chang
4343
- `/speckit.release` - Release documentation management
4444
- `/speckit.personalize` - Per-user prompt customization
4545

46-
5. **Documentation Structure**
46+
4. **Documentation Structure**
4747
- Renamed `.specify/``.documentation/` for clarity
4848
- Extensive migration guides and tooling
4949
- Constitution guide, critic usage guide, PR review implementation
5050
- Adaptive lifecycle documentation
5151

52-
6. **Scripts & Automation**
52+
5. **Scripts & Automation**
5353
- `evolution-context.sh/ps1` - Constitution evolution support
5454
- `get-pr-context.sh/ps1` - PR context extraction
5555
- `quickfix-context.sh/ps1` - Lightweight fix workflow
5656
- `release-context.sh/ps1` - Release management
5757
- `site-audit.sh/ps1` - Website auditing
5858

59-
7. **Repository Health**
59+
6. **Repository Health**
6060
- Git Spark reports (HTML/MD)
6161
- Enhanced branch protection documentation
6262
- Fork-specific release management

spec-driven.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,7 @@ SDD is a methodology, not a tool — and Spec Kit embodies this principle throug
6767
The same specification workflow works identically whether your team uses Claude Code, GitHub Copilot, Gemini CLI, Cursor, or any of 17+ supported agents. Canonical prompts live in `.documentation/commands/` as a single source of truth; platform-specific directories (`.claude/`, `.github/`, `.cursor/`, etc.) contain only thin shims that redirect to the canonical content.
6868

6969
This means:
70+
7071
- **No agent lock-in** — switch tools without losing workflow structure
7172
- **Mixed-agent teams** — different team members can use their preferred AI assistant on the same project
7273
- **Consistent governance** — the same constitution and quality gates apply regardless of which agent executes them
@@ -76,6 +77,7 @@ This means:
7677
Teams share constitutions, specs, and workflow governance — but individuals can customize how they interact with those workflows. The `/speckit.personalize` command creates per-user prompt overrides in `.documentation/{git-user}/commands/` that take priority over shared defaults.
7778

7879
This balances:
80+
7981
- **Team benefit** — shared standards, consistent output quality, unified governance
8082
- **Individual freedom** — each developer can tune prompts to their thinking style, add personal checklists, or emphasize areas they care about
8183
- **Transparency** — personalized overrides are committed to git, so the team can see and review each other's customizations

templates/commands/personalize.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ over the shared defaults in `.documentation/commands/` when any speckit command
5656

5757
4. **Create the user directory structure**:
5858

59-
```
59+
```text
6060
.documentation/{git-user}/commands/
6161
```
6262

@@ -85,7 +85,7 @@ over the shared defaults in `.documentation/commands/` when any speckit command
8585

8686
7. **Inform the user**:
8787

88-
```
88+
```text
8989
Created personalized prompt:
9090
.documentation/{git-user}/commands/speckit.{command}.md
9191

0 commit comments

Comments
 (0)