メインコンテンツまでスキップ

l-make-link-plan

Link Plan Workflow

Find linkable keywords in the latest blog article, search for their URLs, and apply the links.

Steps​

1. Identify the target article​

Determine which article to process:

  • Check git diff --name-only for uncommitted changes in blog/src/articles/
  • Check git log --oneline -10 --diff-filter=AM -- blog/src/articles/ for recently added or modified articles
  • If the user specified an article, use that
  • If multiple candidates exist or the target is unclear, ask the user

Read the full content of the target article.

Analyze the article content and identify keywords/terms that would benefit from external links. Skip terms that are already linked in the article.

Present candidates in two groups:

1st candidates (natural to link - well-known tools, libraries, frameworks, APIs, services directly discussed in the article):

  • e.g., framework names, library names, specific API references, tools mentioned by name

2nd candidates (optional - general concepts, companies, standards that readers likely already know):

  • e.g., well-known companies, common programming concepts, broadly known services

For each candidate, briefly note what it is (e.g., "official site", "GitHub repo", "API docs").

3. Ask the user​

Present both groups and ask the user which keywords to link. Wait for the user's reply before proceeding.

4. Search for URLs​

Use WebSearch to find the official/canonical URL for each approved keyword. Prefer:

  • Official project websites over Wikipedia
  • GitHub repos for libraries/packages
  • Official API documentation pages for API references
  • npm/PyPI pages only if no official site exists

Present the results in this exact format and copy to clipboard via pbcopy:

Web Site Title
https://example.com/
Web Site Title
https://example.com/

Each entry is: title line, URL line, then blank line separator. Run pbcopy with the formatted text.

6. Wait for user confirmation​

Wait for the user to confirm. The user may adjust the list or approve as-is.

7. Apply links to the article​

After confirmation, apply markdown links to the first occurrence of each keyword in the article. Use standard markdown link syntax: [keyword](url).

  • Only link the first occurrence of each keyword
  • For inline code keywords like `globalShortcut`, use [`globalShortcut`](url)
  • Do not modify code blocks or frontmatter