Takazudo Modular Docs

Type to search...

to open search from anywhere

l-text-expand-story

Expand bullet points or brief notes into a fuller story/narrative with imagination, following the project's writing style.

Text Expand Story Command

The user wants to expand brief bullet points or notes into a more detailed, narrative story. This is more than just polishing - it requires imagination to flesh out the ideas into engaging prose.

Input

The user provides brief bullet points or notes like:

/text-expand-story

- モジュラーシンセの魅力は自分だけのシステムを組めること
- パッチングで音作りの可能性が無限大
- 最初は小さく始めて徐々に拡張できる

The text after /text-expand-story is the target text to expand.

Your Task

1. Find the Source Location

Locate which file contains this text. Use these strategies in order:

  1. Check current unstaged changes (PRIMARY) - Run git diff to see the actual content of unstaged changes. The target text should be in the added lines (lines starting with +). This is the most likely location since the user just typed the text.
  2. Search for the text - If not found in unstaged changes, use grep to find the exact location
  3. Check recently modified files - Use find src/mdx/notes -name "*.mdx" | xargs ls -lt | head -10

2. Read Context

Once you find the file and line, read the surrounding content (at least 30-50 lines before and after) to understand:

  • The overall topic and flow of the article
  • The writing style being used
  • What story the author is trying to tell
  • The emotional tone and pacing

3. Read Writing Rules

Read these files to understand the proper article writing style:

  • .claude/skills/_shared/writing-voice.md — READ FIRST. Project-wide rule: AI writes facts, the human author adds emotional / personal layers later. This applies to /text-expand-story too — even though “expand” sounds like creative latitude, it does NOT include inventing the author’s reactions, feelings, or personal judgements.
  • doc/docs/writing/writing-style.md
  • doc/docs/writing/markdown-writing-rule.md
  • doc/docs/writing/vocabulary-rule.md

4. Expand the Story

Transform the brief notes into a fuller narrative — factually. Expansion here means adding context, transitions, and explanation around the bullet points, NOT inventing emotion the author didn’t write.

Key principles:

  • Stay literal — Read the bullets at face value; do not invent a backstory, motivation, or feeling that the bullets do not state.
  • Add factual context — When a bullet implies a fact (a how, a why, a technical detail), expand on the fact with information that any reader of the source / spec / video would also know.
  • Include transitions — Connect ideas naturally so the prose flows.
  • DO NOT add personal touches — no “筆者は◯◯と考えています”, no “自分は◯◯と感じる”, no first-person reactions, no anticipated reader emotions. The author adds those after AI writing. See the forbidden-categories table in _shared/writing-voice.md.
  • Create narrative rhythm — Vary sentence length and structure for readability, but vary at the factual-content level, not by injecting feelings.

Example transformation (facts-only expansion):

Input:

- モジュラーシンセの魅力は自分だけのシステムを組めること
- パッチングで音作りの可能性が無限大
- 最初は小さく始めて徐々に拡張できる

Output:

モジュラーシンセは、利用者が必要なモジュールを選び、自分のシステムを組み上げる楽器です。既製品のシンセサイザーと異なり、オシレーター、フィルター、エフェクトなどを個別に選定し、ケースに収めて1台のシステムを構成します。

各モジュール間はパッチケーブルで接続します。接続の組み合わせを変えると、信号の流れが変わり、結果として出力されるサウンドも変化します。同じ構成のシステムでもパッチングの違いで異なる音作りが可能です。

システムは小規模から構築できます。電源付きのケースと数個のモジュールがあれば最小構成のシステムが組み立てられ、必要に応じて後からモジュールを追加して拡張していく形が一般的です。

Notes on this example:

  • No “ではないでしょうか” / “真骨頂” / “ご安心ください” / “筆者は◯◯と考えています”
  • The expansion adds facts (オシレーター・フィルター・エフェクト, ケーブル接続, 電源付きケース) — context any source could verify — not feelings or reader-anticipation
  • The slot for Takazudo’s voice (どこが楽しいのか, どう感じたか) is intentionally left untouched — that’s the human’s job after this expansion lands

5. Replace the Text

After expanding, directly replace the original bullet points in the file with the expanded narrative using the Edit tool. No need to present multiple candidates.

6. Show the Result

After making the edit, show the user:

  • The original bullet points
  • The expanded narrative that was written
  • A brief explanation of what was added (motivations, transitions, personal touches)

Important Notes

  • Be creative but faithful - Expand the ideas, but stay true to what the author likely intended
  • Read the surrounding context carefully - The expansion should fit naturally with adjacent paragraphs
  • Maintain the author’s voice - Use Takazudo’s characteristic style from the writing guide
  • Add substance, not fluff - Each addition should serve the narrative, not just pad word count
  • Consider the reader’s journey - Guide them through the story with clear progression
  • This is a direct replacement - no need to ask for confirmation or provide alternatives

Arguments

$ARGUMENTS - The bullet points or brief notes to expand into a fuller story