Skip to content

Commit 3761314

Browse files
committed
style(docs): replace em/en-dashes with ASCII hyphens
- Replace U+2014 (em-dash) and U+2013 (en-dash) with '-' across rules and skills for plain-ASCII consistency - Scoped via rg (respects .gitignore); no changes to .git, node_modules, or lockfiles - 37 replacements across 17 files; no semantic changes
1 parent d9fa1d7 commit 3761314

17 files changed

Lines changed: 36 additions & 36 deletions

File tree

rules/010-workflow.mdc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ For non-trivial work, keep a single “north star” scope document and use it t
9393
- **Rule**: Break work into features small enough for the agent to execute reliably (one feature per cycle)
9494

9595
**When to create `tmp/design.md`:**
96-
- Level 34 tasks (multi-module or architectural)
96+
- Level 3-4 tasks (multi-module or architectural)
9797
- Any time there are multiple valid approaches with meaningful tradeoffs
9898
- Any time interfaces, data models, or operational behaviors might change
9999

rules/015-context-engineering.mdc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,9 +38,9 @@ This rule strengthens agent performance by making context **intentional**, **min
3838
### Always carry (paste/recap)
3939

4040
- **Goal**: one sentence
41-
- **Non-goals**: 13 bullets
41+
- **Non-goals**: 1-3 bullets
4242
- **Constraints**: security, tooling, performance, “don’t refactor”, etc.
43-
- **Current plan**: 37 steps max
43+
- **Current plan**: 3-7 steps max
4444
- **Current state**: what’s done / what’s blocked
4545
- **Critical artifacts**: exact file paths, key identifiers, and error messages (verbatim)
4646

rules/100-core.mdc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -486,7 +486,7 @@ def process_order(order_id: int) -> Order:
486486

487487
* Over-engineered abstractions for simple problems.
488488
* Premature optimization.
489-
* Extensive test suites (provide 12 examples instead).
489+
* Extensive test suites (provide 1-2 examples instead).
490490
* Complex frameworks when stdlib suffices.
491491
* Features not in requirements.
492492
* Generic boilerplate text or “best practices” not tied to the task (“AI slop”).

rules/130-git.mdc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ git merge origin/main # Integrate when ready
5151

5252
**What is the Reflog?**
5353

54-
The **reflog** (reference log) is Git's time machine. While `git log` shows only commits reachable from branches/tags, the reflog records **every movement of HEAD** every checkout, reset, commit, rebase, branch switch, and even "lost" commits.
54+
The **reflog** (reference log) is Git's time machine. While `git log` shows only commits reachable from branches/tags, the reflog records **every movement of HEAD** - every checkout, reset, commit, rebase, branch switch, and even "lost" commits.
5555

5656
**Key insight:** The reflog remembers everything, even commits that appear "lost" from your branch history. This makes Git operations reversible and gives you confidence to experiment.
5757

@@ -63,7 +63,7 @@ The **reflog** (reference log) is Git's time machine. While `git log` shows only
6363
- **Debugging** - Track "what commit was I on 20 minutes ago?"
6464
- **Learning** - Understand Git internals by watching HEAD movements
6565

66-
**Reflog is your safety net** it makes "dangerous" operations safe because you can always undo them.
66+
**Reflog is your safety net** - it makes "dangerous" operations safe because you can always undo them.
6767

6868
### Basic Reflog Usage
6969

@@ -794,7 +794,7 @@ pre-commit autoupdate
794794
Every repo **must** contain the following foundational files with project-appropriate content.
795795

796796
> [!IMPORTANT]
797-
> **Always use `.yaml` extension, NOT `.yml`** This is a project-wide convention for consistency and clarity.
797+
> **Always use `.yaml` extension, NOT `.yml`** - This is a project-wide convention for consistency and clarity.
798798

799799
## Required Files
800800

rules/200-python.mdc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2971,7 +2971,7 @@ def function_name(param: str) -> int:
29712971
## 17) Scaling Guidelines
29722972

29732973
- **Small Scripts (<50 lines):** Stick to basics - skip advanced features unless critical.
2974-
- **Medium Scripts (50200 lines):** Add type hints, logging, small functions. Consider `argparse` or `Pydantic`.
2974+
- **Medium Scripts (50-200 lines):** Add type hints, logging, small functions. Consider `argparse` or `Pydantic`.
29752975
- **Large Projects (>200 lines):** Use OOP, SOLID principles, plugins, deployment tools. Optimize with profiling/concurrency.
29762976

29772977
## 18) Example Script

rules/412-aws-iam.mdc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -194,7 +194,7 @@ If a vendor assumes a role in your account, require an `ExternalId` and lock to
194194

195195
When a **resource-based policy** grants access to an **AWS service principal** (for example,
196196
`cloudtrail.amazonaws.com`, `events.amazonaws.com`, `sns.amazonaws.com`), the policy is trusting the
197-
service principal not the human/role that configured the calling service.
197+
service principal - not the human/role that configured the calling service.
198198

199199
To reduce confused-deputy risk, restrict the service principal with global condition keys:
200200

rules/800-markdown.mdc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -486,11 +486,11 @@ Use standard Markdown links so URLs render as clickable in GitHub, IDEs, and com
486486

487487
- **Preferred**: `[AWS Lambda documentation](https://docs.aws.amazon.com/lambda/)`
488488
- **Avoid for navigation**: bare URLs in running text when a short label reads better (still use `https://...` in link target)
489-
- **Do not** wrap URLs that readers should **click** in backticks: `` `https://docs.aws.amazon.com/lambda/` `` inline code styling often prevents click-through and copies poorly.
489+
- **Do not** wrap URLs that readers should **click** in backticks: `` `https://docs.aws.amazon.com/lambda/` `` - inline code styling often prevents click-through and copies poorly.
490490

491491
### When backticks around a URL are correct
492492

493-
Wrap a URL in backticks only when it is a **literal value**, not a navigation affordancefor example: configuration samples, CLI transcripts, log lines, schema defaults, or strings inside code-oriented examples.
493+
Wrap a URL in backticks only when it is a **literal value**, not a navigation affordance-for example: configuration samples, CLI transcripts, log lines, schema defaults, or strings inside code-oriented examples.
494494

495495
### Paths and anchors
496496

rules/810-documentation.mdc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -250,9 +250,9 @@ Prefer **neutral** or **imperative** phrasing over second-person voice.
250250

251251
### Punctuation
252252

253-
**Never use em dashes () or en dashes (). Use hyphens (-) instead.**
253+
**Never use em dashes (-) or en dashes (-). Use hyphens (-) instead.**
254254

255-
- **Bad:** `Astral's type checker10x faster than mypyis now available.`
255+
- **Bad:** `Astral's type checker-10x faster than mypy-is now available.`
256256
- **Good:** `Astral's type checker - 10x faster than mypy - is now available.`
257257

258258
**Rationale:**

skills/agent-workflow/references/context-engineering.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,9 @@ It complements:
3333
### Always carry
3434

3535
- **Goal**: one sentence
36-
- **Non-goals**: 13 bullets
36+
- **Non-goals**: 1-3 bullets
3737
- **Constraints**: security, tooling, “don’t refactor”, etc.
38-
- **Current plan**: 37 steps max
38+
- **Current plan**: 3-7 steps max
3939
- **Current state**: what’s done / what’s blocked
4040
- **Critical artifacts**: exact file paths, key identifiers, and error messages (verbatim)
4141

skills/agent-workflow/references/context-management.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ For non-trivial work, keep a single “north star” scope document and use it t
4141

4242
**When to create `tmp/design.md`:**
4343

44-
- Level 34 tasks (multi-module or architectural)
44+
- Level 3-4 tasks (multi-module or architectural)
4545
- Any time there are multiple valid approaches with meaningful tradeoffs
4646
- Any time interfaces, data models, or operational behaviors might change
4747

0 commit comments

Comments
 (0)