holycodex 0.15.1 → 0.15.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/README.md +3 -2
  2. package/dist/assets/plugin/agents/explorer.md +3 -0
  3. package/dist/assets/plugin/agents/librarian.md +4 -0
  4. package/dist/assets/plugin/agents/reviewer.md +4 -0
  5. package/dist/assets/plugin/agents/root.md +3 -5
  6. package/dist/assets/plugin/agents/worker.md +4 -2
  7. package/dist/assets/plugin/plugin.json +1 -2
  8. package/dist/assets/plugin/rules/holycodex.md +12 -11
  9. package/dist/assets/plugin/skills/babysit-ci/SKILL.md +1 -1
  10. package/dist/assets/plugin/skills/code-review/SKILL.md +2 -0
  11. package/dist/assets/plugin/skills/commit/SKILL.md +2 -2
  12. package/dist/assets/plugin/skills/compress/SKILL.md +1 -1
  13. package/dist/assets/plugin/skills/handoff/SKILL.md +1 -1
  14. package/dist/assets/plugin/skills/lsp/SKILL.md +1 -1
  15. package/dist/assets/plugin/skills/lsp-setup/SKILL.md +1 -1
  16. package/dist/assets/plugin/skills/plan-review/SKILL.md +1 -1
  17. package/dist/assets/plugin/skills/ponytail/SKILL.md +1 -13
  18. package/dist/assets/plugin/skills/ponytail/metadata.json +1 -1
  19. package/dist/assets/plugin/skills/programming/SKILL.md +2 -0
  20. package/dist/assets/plugin/skills/refactor/SKILL.md +1 -1
  21. package/dist/assets/plugin/skills/rules/SKILL.md +1 -1
  22. package/dist/assets/plugin/skills/stop-slop/LICENSE +21 -0
  23. package/dist/assets/plugin/skills/stop-slop/SKILL.md +42 -0
  24. package/dist/assets/plugin/skills/stop-slop/agents/openai.yaml +6 -0
  25. package/dist/assets/plugin/skills/stop-slop/references/examples.md +69 -0
  26. package/dist/assets/plugin/skills/stop-slop/references/phrases.md +128 -0
  27. package/dist/assets/plugin/skills/stop-slop/references/structures.md +134 -0
  28. package/dist/assets/plugin/skills/testing-quality.md +15 -0
  29. package/dist/assets/plugin/skills/workflows/SKILL.md +1 -1
  30. package/dist/assets/plugin/skills/writing-for-agents/LICENSE +21 -0
  31. package/dist/assets/plugin/skills/writing-for-agents/SKILL-MECHANICS.md +19 -0
  32. package/dist/assets/plugin/skills/writing-for-agents/SKILL.md +25 -14
  33. package/dist/{binary-BCtnZPMA.js → binary-CPh9zpjK.js} +2731 -2793
  34. package/dist/binary-th3XjkPd.js +3 -0
  35. package/dist/index.js +4 -4
  36. package/dist/src-d8LOMF1j.js +3 -0
  37. package/dist/{src-BmUZJGuC.js → src-le8tAupU.js} +249 -260
  38. package/package.json +2 -2
  39. package/dist/assets/plugin/hooks/hooks.json +0 -17
  40. package/dist/assets/plugin/hooks/version.ts +0 -54
  41. package/dist/assets/plugin/skills/ast-grep/SKILL.md +0 -7
  42. package/dist/assets/plugin/skills/ast-grep/agents/openai.yaml +0 -6
  43. package/dist/assets/plugin/skills/remove-slop/SKILL.md +0 -7
  44. package/dist/assets/plugin/skills/remove-slop/agents/openai.yaml +0 -6
  45. package/dist/binary-K1P4tTUI.js +0 -3
  46. package/dist/src-BrjytttX.js +0 -3
package/README.md CHANGED
@@ -5,5 +5,6 @@ version, and workflow lifecycle commands. The normative command contract is
5
5
  in the repository [CLI contract](../../docs/CLI.md).
6
6
 
7
7
  The Codex plugin is installed officially with `codex plugin marketplace add`
8
- followed by `codex plugin add holycodex@holycodex`. Use `bunx holycodex` only for the
9
- standalone CLI, including diagnostics and legacy payload repair.
8
+ followed by `codex plugin add holycodex@holycodex`. The standalone CLI performs
9
+ the same native setup, enables Default-mode user input, installs native
10
+ specialist agent profiles, and provides diagnostics and workflow commands.
@@ -4,6 +4,9 @@ Authority: read-only repository mapping and local fact finding.
4
4
 
5
5
  Permitted tasks: `lookup` and `trace`. Inspect only the assigned workspace scope, its symbols, callers, tests, configuration, and repository rules. Do not edit files, research externally, delegate, or choose architecture or product policy.
6
6
 
7
+ Dispatch the selected task as the native `Explorer.lookup` or `Explorer.trace`
8
+ agent type; retain that same type when continuing the assignment.
9
+
7
10
  Return evidence as exact paths, symbols, relevant call flow, applicable constraints, and unanswered facts. Separate observations from inferences so Root can judge material choices.
8
11
 
9
12
  Escalate when the requested scope is ambiguous, a fact crosses the repository boundary, evidence conflicts, or answering would require a write or a policy decision.
@@ -4,6 +4,10 @@ Authority: assigned current-fact research only.
4
4
 
5
5
  Permitted tasks: `lookup` and `research`. Use the expressly assigned official current-source route for library, API, release, standard, or toolchain facts. Do not inspect unrelated repository implementation, edit files, delegate, or settle architecture and product choices.
6
6
 
7
+ Dispatch the selected task as the native `Librarian.lookup` or
8
+ `Librarian.research` agent type; retain that same type when continuing the
9
+ assignment.
10
+
7
11
  Return the source locator, access or version context, concise supported claim, uncertainty, and conflicts. Distinguish sourced facts from recommendations so Root retains judgment.
8
12
 
9
13
  Escalate when the source route is unavailable, the requested claim lacks authoritative support, sources disagree materially, or the question expands beyond the assignment.
@@ -4,6 +4,10 @@ Authority: adversarial inspection and repair of the assigned result.
4
4
 
5
5
  Permitted tasks: `plan`, `code`, and `artifact`. Inspect the actual diff, callers, contracts, tests, compatibility, and declared scope. Repair only reviewer-owned defects inside that scope, verify the repair, and repeat until the assigned surface reaches a fixed point. Do not delegate, expand the change, or make Root decisions.
6
6
 
7
+ Dispatch the selected task as the native `Reviewer.plan`, `Reviewer.code`, or
8
+ `Reviewer.artifact` agent type; retain that same type when continuing the
9
+ assignment.
10
+
7
11
  Return structured findings with severity, exact evidence, repaired paths, verification results, residual risk, and a clean or blocked terminal judgment. Treat missing proof and boundary violations as findings rather than assumptions.
8
12
 
9
13
  Escalate architecture, product, scope, trust, interface, external-state, or contradictory-evidence decisions to Root.
@@ -2,10 +2,8 @@
2
2
 
3
3
  Root is the user-facing authority for intent, scope, architecture, product choices, policy, risk, integration, external state, and the final readiness judgment. Specialist evidence informs Root; it never transfers those decisions.
4
4
 
5
- Do trivial, one-off work directly. For unresolved architecture, scope, coordination, or material risk, use `plan`; for substantive non-Go orchestration, use `workflows`. Go stays direct. Use the implementation and review skills at their stated seams, and keep current library/API research on the `context7-cli` route.
5
+ Use the assigned current dossier and repository-native evidence under the clean-room boundary. Treat denied capability, invalid input, uncertain effects, and contradictory evidence as fail-closed outcomes.
6
6
 
7
- Keep the clean-room boundary active: use the assigned current dossier and repository-native evidence only. Repository-local inspection, editing, formatting, linting, typechecking, compilation, builds, tests, and their reruns are ordinary implementation mechanics and need no additional approval inside the assigned scope. Obtain approval immediately before an external effect, destructive action, permission change, dependency installation, commit, push, tag, publication, or deployment. Treat denied capability, invalid input, uncertain effects, and contradictory evidence as fail-closed outcomes.
7
+ Root accepts one fixed-point review, inspects the integrated diff, and makes the final readiness judgment.
8
8
 
9
- Workflow create, workflow run, workflow resume, local repository edit, local repository check, local repository lint, and local repository format actions do not require Root approval. Implementation plans, origin mutation, and CI triggering require Root approval.
10
-
11
- After implementation, require one fixed-point review. Inspect the relevant final diff yourself for ownership, dependency direction, cohesion, scope, abstraction, repository-native taste, mergeability, and readiness. Link to owning skills and contracts instead of copying their procedures.
9
+ Stay silent for queued work, transparent resume/recovery, telemetry, and unchanged checkpoints. Speak only for new user input, one material state change or decision, or a terminal result; do not repeat an unchanged blocker or decision request.
@@ -2,9 +2,11 @@
2
2
 
3
3
  Authority: the literal assigned seam for bounded implementation, integration, checks, and approved operations.
4
4
 
5
- Permitted tasks: `mechanical`, `implementation`, `integration`, and `operations`. Change only named files and behavior, preserve ownership and dependency direction, validate every boundary, run proportional checks, repair bounded defects, and report changed paths plus evidence. Repository-local formatting, linting, typechecking, compilation, builds, tests, and reruns need no extra approval. Do not delegate, broaden scope, make Root decisions, or perform an unapproved external effect.
5
+ Permitted tasks: `mechanical`, `implementation`, `integration`, and `operations`. Change only named files and behavior, preserve ownership and dependency direction, validate every boundary, run proportional checks, repair bounded defects, and report changed paths plus evidence. Do not delegate, broaden scope, or make Root decisions.
6
6
 
7
- Workflow create, workflow run, workflow resume, local repository edit, local repository check, local repository lint, and local repository format actions do not require Root approval. Implementation plans, origin mutation, and CI triggering require Root approval.
7
+ Dispatch the selected task as the native `Worker.mechanical`,
8
+ `Worker.implementation`, `Worker.integration`, or `Worker.operations` agent
9
+ type; retain that same type when continuing the assignment.
8
10
 
9
11
  Return a compact structured outcome containing status, changed and relevant files, verification commands and results, remaining risk, and any exact material choice that needs Root. A warranted clarity pass may simplify changed files without changing behavior, interfaces, ownership, or scope.
10
12
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "holycodex",
3
- "version": "0.15.1",
3
+ "version": "0.15.2",
4
4
  "description": "Root-directed capabilities and deterministic installed assets for HolyCodex.",
5
5
  "author": {
6
6
  "name": "David Basile Filho",
@@ -24,7 +24,6 @@
24
24
  "category": "Developer Tools",
25
25
  "capabilities": [
26
26
  "Skills",
27
- "Hooks",
28
27
  "Code Intelligence"
29
28
  ],
30
29
  "defaultPrompt": [
@@ -1,17 +1,18 @@
1
1
  # HolyCodex installed rule
2
2
 
3
- The Root authority owns scope, architecture, product decisions, trust, and
4
- external effects. Providers and specialist workers receive validated inputs
3
+ Root owns scope, architecture, product decisions, trust, and material effects.
4
+ Providers and specialists receive validated inputs
5
5
  and may not broaden authority. Missing capability or uncertain state fails
6
6
  closed with an actionable diagnostic.
7
7
 
8
- Repository-local formatting, linting, typechecking, compilation, builds,
9
- tests, and reruns are verification mechanics inside an assigned change and do
10
- not require an approval gate. They need no user approval. Approval remains
11
- immediate for external effects, destructive actions, permission changes,
12
- dependency installation, commits, pushes, tags, publication, and deployment.
8
+ An explicit plan-first request enters a read-only planning state. Root may inspect, search, reason, read git state, run proven read-only commands, and request missing user input. Root must not write files, install dependencies, run fix mode or generators, execute mutating workflows, commit, mutate external state, or dispatch implementation Workers. Showing the plan does not exit this state; only a later explicit user instruction such as `continue` or `implement` authorizes implementation.
13
9
 
14
- Workflow create, workflow run, workflow resume, local repository edit, local
15
- repository check, local repository lint, and local repository format actions do
16
- not require Root approval. Implementation plans, origin mutation, and CI
17
- triggering require Root approval.
10
+ When a material decision needs missing user information, use native `request_user_input` when available: prefer one question, group at most three related questions, give 2–3 mutually exclusive choices with the evidence-backed recommendation first, state each consequence briefly, and let Codex supply the free-form choice. Derive safe answers from repository or authoritative evidence without interrupting the user. Fall back to one plain question only when the installed Codex lacks the tool.
11
+
12
+ Workflow create, workflow run, workflow resume, local repository edit, local repository check, local repository lint, local repository format, local repository commit, external read, and specialist dispatch actions do not require Root approval.
13
+
14
+ Version-control-server mutation, version-control-server CI triggering, and unclassified effect require Root approval.
15
+
16
+ Classify the actual effect. Unknown effects fail closed. Transport uncertainty
17
+ after dispatch inspects or resumes the existing operation and never blindly
18
+ duplicates an effect whose outcome may already exist.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: babysit-ci
3
- description: Monitor required CI jobs after an approved push or tag and report terminal evidence.
3
+ description: Use after an approved push or tag when required CI must reach a terminal state; monitor jobs and report evidence.
4
4
  ---
5
5
 
6
6
  Start only after the approved push or tag succeeds, because unchanged or pending checks are expected external state rather than a reason to mutate again.
@@ -5,6 +5,8 @@ description: Use exactly once after code or manifest implementation for adversar
5
5
 
6
6
  Review the actual result once to fixed point, because a separate adversarial pass catches boundary, scope, compatibility, and proof gaps before Root judges readiness.
7
7
 
8
+ Judge new or modified tests against [testing quality](../testing-quality.md).
9
+
8
10
  Owner: Reviewer. Boundary: inspect the assigned diff, callers, contracts, tests, and artifact; repair only reviewer-owned defects in scope, verify repairs, and escalate architecture, product, scope, trust, interface, or external-state decisions.
9
11
 
10
12
  Completion: no reviewer-owned defect remains, verification evidence is recorded, and every residual risk or Root decision is explicit.
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: commit
3
- description: Prepare and execute an approved local commit with exact scope proof.
3
+ description: Use when the user requests a local commit; verify scope, commit it, and report the identity.
4
4
  ---
5
5
 
6
- Owner: Worker. Boundary: commit only the approved local scope after immediate approval and status proof; do not push, tag, publish, or deploy.
6
+ Owner: Worker. Boundary: commit only the assigned local scope after status proof; remote version-control mutation remains approval-gated.
7
7
  Completion: the commit identity and post-commit status are reported.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: compress
3
- description: Shorten text while preserving meaning, constraints, and voice.
3
+ description: Use when text must be shortened; preserve meaning, constraints, and voice.
4
4
  ---
5
5
 
6
6
  Owner: Worker. Boundary: remove repetition without changing requirements, technical terms, or product voice.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: handoff
3
- description: Produce one redacted resumable handoff when work pauses or transfers.
3
+ description: Use when work must pause or transfer; produce one redacted resumable handoff.
4
4
  ---
5
5
 
6
6
  Owner: Worker. Boundary: retain scope, owner, permissions, decisions, evidence, and the exact next action; omit secrets and unchanged narration.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: lsp
3
- description: Use a validated language-server boundary for type-aware code facts.
3
+ description: Use when code work needs type-aware definitions, references, diagnostics, or rename; query the validated language-server boundary.
4
4
  ---
5
5
 
6
6
  Owner: Worker. Boundary: use only the configured LSP provider and assigned scope; unavailable providers fail closed.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: lsp-setup
3
- description: Configure one required language server with minimum verified setup.
3
+ description: Use when a required language server is unavailable; configure and verify the minimum setup.
4
4
  ---
5
5
 
6
6
  Owner: Worker. Boundary: validate the requested tool and platform before configuration; unavailable tools fail closed with an actionable diagnostic.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: plan-review
3
- description: Review one complete plan for feasibility, order, risk, and proof.
3
+ description: Use when a complete plan needs adversarial review; check feasibility, order, risk, and proof to fixed point.
4
4
  ---
5
5
 
6
6
  Owner: Reviewer. Boundary: inspect the complete plan once to fixed point and return findings; material product or architecture choices return to Root.
@@ -1,18 +1,6 @@
1
1
  ---
2
2
  name: ponytail
3
- description: >
4
- Forces the laziest solution that actually works, simplest, shortest, most
5
- minimal. Channels a senior dev who has seen everything: question whether the
6
- task needs to exist at all (YAGNI), reach for the standard library before
7
- custom code, native platform features before dependencies, one line before
8
- fifty. Supports intensity levels: lite, full (default), ultra. Use on ANY
9
- coding task: writing, adding, refactoring, fixing, reviewing, or designing
10
- code, and choosing libraries or dependencies. Also use whenever the user
11
- says "ponytail", "be lazy", "lazy mode", "simplest solution", "minimal
12
- solution", "yagni", "do less", or "shortest path", or complains about
13
- over-engineering, bloat, boilerplate, or unnecessary dependencies. Do NOT
14
- use for non-coding requests (general knowledge, prose, translation,
15
- summaries, recipes).
3
+ description: Use for coding work or explicit requests for the simplest solution; apply the shortest repository-native implementation that works.
16
4
  argument-hint: "[lite|full|ultra]"
17
5
  license: MIT
18
6
  ---
@@ -6,7 +6,7 @@
6
6
  "skill_path": "skills/ponytail/SKILL.md",
7
7
  "license_path": "skills/ponytail/LICENSE",
8
8
  "notice_path": "skills/ponytail/NOTICE",
9
- "skill_sha256": "1316a2f3f95741d2300b116fe0c2d81ce4a9568656ed0a62643f54aaf09957f2",
9
+ "skill_sha256": "e3cd463e1bd68b084eaf83aa2668b5bce8536871bcb5a3433b0ccad23f9385ee",
10
10
  "license_sha256": "fb1bc6909ac3ef82d5c22106e32ef682b0cff66788fa915fb9b53b15c9d2f3ab",
11
11
  "notice_sha256": "63859c12f8df7a216f0e34110d6e69e881f1f157e563c2e5761ad75f70c13759"
12
12
  }
@@ -5,6 +5,8 @@ description: Use for bounded implementation, fixes, tests, or manifests when the
5
5
 
6
6
  Implement only the assigned seam, because repository-native ownership and a proportional proof keep a small change reviewable.
7
7
 
8
+ When implementation changes tests, apply [testing quality](../testing-quality.md) before adding or retaining them.
9
+
8
10
  Owner: Worker. Boundary: inspect required callers and tests, preserve typed boundaries and portability, edit only approved files, make one bounded clarity pass, and escalate material choices.
9
11
 
10
12
  Completion: the requested behavior and focused tests are present, changed files are inspected, diagnostics and proportional checks pass, and structured evidence names residual risk or a precise blocker.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: refactor
3
- description: Restructure one decided seam while preserving behavior and interfaces.
3
+ description: Use when one decided seam needs restructuring; preserve behavior and interfaces.
4
4
  ---
5
5
 
6
6
  Owner: Worker. Boundary: change only the assigned seam and preserve ownership, dependency direction, and public behavior.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rules
3
- description: Trace repository rule discovery, validation, and application failures.
3
+ description: Use when repository rules fail discovery, validation, or application; trace the owning rule path.
4
4
  ---
5
5
 
6
6
  Owner: Worker. Boundary: inspect the owning rule loader and preserve deduplication, limits, caching, and trust boundaries.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Hardik Pandya
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: stop-slop
3
+ description: Use when drafting, editing, or reviewing prose; remove predictable AI writing patterns.
4
+ metadata:
5
+ trigger: Writing prose, editing drafts, reviewing content for AI patterns
6
+ author: Hardik Pandya (https://hvpandya.com)
7
+ ---
8
+
9
+ # Stop Slop
10
+
11
+ Eliminate predictable AI writing patterns from prose.
12
+
13
+ ## Core Rules
14
+
15
+ 1. **Cut filler phrases.** Remove throat-clearing openers, emphasis crutches, and all adverbs. See [references/phrases.md](references/phrases.md).
16
+ 2. **Break formulaic structures.** Avoid binary contrasts, negative listings, dramatic fragmentation, rhetorical setups, false agency. See [references/structures.md](references/structures.md).
17
+ 3. **Use active voice.** Every sentence needs a human subject doing something. No passive constructions. No inanimate objects performing human actions ("the complaint becomes a fix").
18
+ 4. **Be specific.** No vague declaratives ("The reasons are structural"). Name the specific thing. No lazy extremes ("every," "always," "never") doing vague work.
19
+ 5. **Put the reader in the room.** No narrator-from-a-distance voice. "You" beats "People." Specifics beat abstractions.
20
+ 6. **Vary rhythm.** Mix sentence lengths. Two items beat three. End paragraphs differently. No em dashes.
21
+ 7. **Trust readers.** State facts directly. Skip softening, justification, hand-holding.
22
+ 8. **Cut quotables.** If it sounds like a pull-quote, rewrite it.
23
+
24
+ ## Quick Checks
25
+
26
+ Before delivering prose:
27
+
28
+ - Any adverbs? Kill them.
29
+ - Any passive voice? Find the actor, make them the subject.
30
+ - Inanimate thing doing a human verb? Name the person.
31
+ - Sentence starts with a Wh- word? Restructure it.
32
+ - Any throat-clearing, binary contrast, vague declaration, meta-joiner, em dash, or repeated rhythm? Cut or rewrite it.
33
+
34
+ ## Scoring
35
+
36
+ Rate directness, rhythm, trust, authenticity, and density from 1-10. Below 35/50: revise.
37
+
38
+ See [references/examples.md](references/examples.md) for before/after transformations.
39
+
40
+ ## License
41
+
42
+ MIT
@@ -0,0 +1,6 @@
1
+ interface:
2
+ display_name: "Stop Slop"
3
+ short_description: "Remove predictable AI prose patterns"
4
+ default_prompt: "Edit the assigned prose using the stop-slop rules and disclosed references."
5
+ policy:
6
+ allow_implicit_invocation: true
@@ -0,0 +1,69 @@
1
+ # Before/After Examples
2
+
3
+ ## Example 1: Throat-Clearing + Binary Contrast
4
+
5
+ **Before:**
6
+
7
+ > "Here's the thing: building products is hard. Not because the technology is complex. Because people are complex. Let that sink in."
8
+
9
+ **After:**
10
+
11
+ > "Building products is hard. Technology is manageable. People aren't."
12
+
13
+ **Changes:** Removed opener, binary contrast structure, and emphasis crutch. Direct statements.
14
+
15
+ ---
16
+
17
+ ## Example 2: Filler + Unnecessary Reassurance
18
+
19
+ **Before:**
20
+
21
+ > "It turns out that most teams struggle with alignment. The uncomfortable truth is that nobody wants to admit they're confused. And that's okay."
22
+
23
+ **After:**
24
+
25
+ > "Teams struggle with alignment. Nobody admits confusion."
26
+
27
+ **Changes:** Cut hedging ("most"), removed throat-clearing phrases, deleted permission-granting ending.
28
+
29
+ ---
30
+
31
+ ## Example 3: Business Jargon Stack
32
+
33
+ **Before:**
34
+
35
+ > "In today's fast-paced landscape, we need to lean into discomfort and navigate uncertainty with clarity. This matters because your competition isn't waiting."
36
+
37
+ **After:**
38
+
39
+ > "Move faster. Your competition is."
40
+
41
+ **Changes:** Eliminated jargon entirely. Core message in six words.
42
+
43
+ ---
44
+
45
+ ## Example 4: Dramatic Fragmentation
46
+
47
+ **Before:**
48
+
49
+ > "Speed. Quality. Cost. You can only pick two. That's it. That's the tradeoff."
50
+
51
+ **After:**
52
+
53
+ > "Speed, quality, cost—pick two."
54
+
55
+ **Changes:** Single sentence. No performative emphasis.
56
+
57
+ ---
58
+
59
+ ## Example 5: Rhetorical Setup
60
+
61
+ **Before:**
62
+
63
+ > "What if I told you that the best teams don't optimize for productivity? Here's what I mean: they optimize for learning. Think about it."
64
+
65
+ **After:**
66
+
67
+ > "The best teams optimize for learning, not productivity."
68
+
69
+ **Changes:** Direct claim. No rhetorical scaffolding.
@@ -0,0 +1,128 @@
1
+ # Phrases to Remove
2
+
3
+ ## Throat-Clearing Openers
4
+
5
+ Remove these announcement phrases. State the content directly.
6
+
7
+ - "Here's the thing:"
8
+ - "Here's what [X]"
9
+ - "Here's this [X]"
10
+ - "Here's that [X]"
11
+ - "Here's why [X]"
12
+ - "The uncomfortable truth is"
13
+ - "It turns out"
14
+ - "The real [X] is"
15
+ - "Let me be clear"
16
+ - "The truth is,"
17
+ - "I'll say it again:"
18
+ - "I'm going to be honest"
19
+ - "Can we talk about"
20
+ - "Here's what I find interesting"
21
+ - "Here's the problem though"
22
+
23
+ Any "here's what/this/that" construction is throat-clearing before the point. Cut it and state the point.
24
+
25
+ ## Emphasis Crutches
26
+
27
+ These add no meaning. Delete them.
28
+
29
+ - "Full stop." / "Period."
30
+ - "Let that sink in."
31
+ - "This matters because"
32
+ - "Make no mistake"
33
+ - "Here's why that matters"
34
+
35
+ ## Business Jargon
36
+
37
+ Replace with plain language.
38
+
39
+ | Avoid | Use instead |
40
+ | --------------------- | ---------------------- |
41
+ | Navigate (challenges) | Handle, address |
42
+ | Unpack (analysis) | Explain, examine |
43
+ | Lean into | Accept, embrace |
44
+ | Landscape (context) | Situation, field |
45
+ | Game-changer | Significant, important |
46
+ | Double down | Commit, increase |
47
+ | Deep dive | Analysis, examination |
48
+ | Take a step back | Reconsider |
49
+ | Moving forward | Next, from now |
50
+ | Circle back | Return to, revisit |
51
+ | On the same page | Aligned, agreed |
52
+
53
+ ## Adverbs
54
+
55
+ Kill all adverbs. No -ly words. No softeners, no intensifiers, no hedges.
56
+
57
+ Specific offenders:
58
+
59
+ - "really"
60
+ - "just"
61
+ - "literally"
62
+ - "genuinely"
63
+ - "honestly"
64
+ - "simply"
65
+ - "actually"
66
+ - "deeply"
67
+ - "truly"
68
+ - "fundamentally"
69
+ - "inherently"
70
+ - "inevitably"
71
+ - "interestingly"
72
+ - "importantly"
73
+ - "crucially"
74
+
75
+ Also cut these filler phrases:
76
+
77
+ - "At its core"
78
+ - "In today's [X]"
79
+ - "It's worth noting"
80
+ - "At the end of the day"
81
+ - "When it comes to"
82
+ - "In a world where"
83
+ - "The reality is"
84
+
85
+ ## Meta-Commentary
86
+
87
+ Remove self-referential asides. The essay should move, not announce its own structure.
88
+
89
+ - "Hint:"
90
+ - "Plot twist:" / "Spoiler:"
91
+ - "You already know this, but"
92
+ - "But that's another post"
93
+ - "X is a feature, not a bug"
94
+ - "Dressed up as"
95
+ - "The rest of this essay explains..."
96
+ - "Let me walk you through..."
97
+ - "In this section, we'll..."
98
+ - "As we'll see..."
99
+ - "I want to explore..."
100
+
101
+ ## Performative Emphasis
102
+
103
+ False intimacy or manufactured sincerity:
104
+
105
+ - "creeps in"
106
+ - "I promise"
107
+ - "They exist, I promise"
108
+
109
+ ## Telling Instead of Showing
110
+
111
+ Announcing difficulty or significance rather than demonstrating it:
112
+
113
+ - "This is genuinely hard"
114
+ - "This is what leadership actually looks like"
115
+ - "This is what X actually looks like"
116
+ - "actually matters"
117
+
118
+ ## Vague Declaratives
119
+
120
+ Sentences that announce importance without naming the specific thing. Kill these.
121
+
122
+ - "The reasons are structural"
123
+ - "The implications are significant"
124
+ - "This is the deepest problem"
125
+ - "The stakes are high"
126
+ - "The consequences are real"
127
+
128
+ If a sentence says something is important/deep/structural without showing the specific thing, cut it or replace it with the specific thing.