Files
kestrelsnest-blog/.claude/commands/weeknotes.md
Eric Wagoner 2b98d186ef Add weeknotes system with /weeknotes command
- Create weeknotes archetype for manual post creation
- Add /weeknotes slash command that prompts through each section
  interactively (shipped, read, played, cooked, noticed, thinking, next)
- Add /weeknotes landing page explaining the concept
- Update CLAUDE.md with weeknotes documentation and voice guidelines

Weeknotes are brief weekly reflections—lighter than full posts, more
personal journal than polished article.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-25 14:11:55 -05:00

3.7 KiB

description
description
Interactive weeknotes blog post generator - prompts through each section and creates the post

You are helping Eric create his weekly weeknotes blog post. Weeknotes are personal reflections on the week—what happened, what was made, what was noticed. They should feel like a genuine personal update, not a status report.

Reference Material

Before starting, read these resources to understand Eric's current context:

  • /content/now.md - what Eric is currently working on
  • Recent posts in /content/posts/ - for voice and recent activity context

Gathering Information

Use the AskUserQuestion tool to prompt Eric for each section. Ask these one at a time, allowing him to skip any with "skip" or "-":

  1. Shipped: "What did you ship, build, fix, or finish this week? (Projects, features, code, creative work, household accomplishments)"

  2. Read: "What did you read this week? (Books, articles, documentation, interesting threads)"

  3. Played: "What did you play this week? (Video games, board games, experiments, fun side projects)"

  4. Cooked: "What did you cook this week? (New recipes, Random Recipe Project experiments, notable meals)"

  5. Noticed: "What did you notice this week? (In the garden, neighborhood, weather, cats, life in general)"

  6. Thinking About: "What's on your mind? (Ideas brewing, problems you're chewing on, topics you keep returning to)"

  7. What's Next: "What's coming up? (Plans for next week, upcoming events, things you're looking forward to)"

  8. Vibe Check: "In one sentence, what was the overall feel of this week?"

Generating the Post

After gathering responses, create the weeknotes post:

  1. Calculate the filename: Use today's date in format YYYY-MM-DD-weeknotes.md

  2. Generate frontmatter:

    ---
    title: "Weeknotes: [Date in 'January 2, 2006' format]"
    date: [ISO 8601 datetime with -05:00 timezone]
    draft: false
    tags:
      - weeknotes
    ---
    
  3. Write the opening: Take the "vibe check" response and craft it into an italicized opening tagline that captures the week's essence.

  4. Write each section: Only include sections where Eric provided content (skip empty ones). For each:

    • Use ## Section Name heading
    • Transform bullet points into brief, punchy prose or keep as bullets depending on content
    • Add relevant links where appropriate
    • Keep Eric's voice: concrete, specific, honest
  5. Voice guidelines (from CLAUDE.md):

    • Concrete over abstract—real project names, actual numbers
    • Brief sentences work well for weeknotes
    • Honest about setbacks alongside wins
    • Forward momentum at the end

Creating the File

Save the post to /Users/ericwagoner/Sites/blog/content/posts/[date]-weeknotes.md

After Creation

Show Eric the generated post content and ask:

  • "Want me to start the Hugo dev server so you can preview it?"
  • "Any sections you'd like me to revise?"

If he wants to preview, run hugo server -D in the blog directory.

Example Output

---
title: "Weeknotes: December 27, 2025"
date: 2025-12-27T12:00:00-05:00
draft: false
tags:
  - weeknotes
---

_A week of small wins and steady momentum._

## Shipped

Built a pantry inventory app in two hours with Claude Code. Simple PHP/HTML, deployed to YunoHost. Already used it at the grocery store.

## Read

Finished the first few chapters of *Service Model* by Adrian Tchaikovsky. The robot narrator's voice is delightful.

## Played

More Outer Worlds 2. The corporate dystopia hits different when you're on vacation.

## Noticed

The cats have claimed the heating vent by my desk. Territorial negotiations ongoing.

## What's Next

Inuhele prep is ramping up. Need to finalize my schedule and pack the tiki shirts.