diff --git a/.claude/commands/weeknotes.md b/.claude/commands/weeknotes.md new file mode 100644 index 00000000..da6d8500 --- /dev/null +++ b/.claude/commands/weeknotes.md @@ -0,0 +1,108 @@ +--- +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**: + ```yaml + --- + 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 + +```markdown +--- +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. +``` diff --git a/CLAUDE.md b/CLAUDE.md index 1e489c0f..cdcf0251 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -52,12 +52,34 @@ hugo new content-name.md The blog uses the "m10c" theme but has two additional themes available (henry, kestrel). Theme switching is done via `config.toml`. ### Content Organization -- `/content/posts/` - Blog posts + +- `/content/posts/` - Blog posts (including weeknotes) - `/content/now.md` - "Now" page showing current activities - `/content/then.md` - "Past" page with historical content - `/content/upcoming.md` - "Future" page with upcoming events +- `/content/weeknotes.md` - Weeknotes landing page - `/content/mytweets.md` - Local tweet archive page +### Weeknotes + +Weeknotes are short weekly reflections on what Eric shipped, read, played, cooked, and noticed. They use a lighter voice than full blog posts—more personal journal than polished article. + +**To create a weeknote**: Run `/weeknotes` to be prompted through each section interactively. + +**Manual creation**: `hugo new --kind weeknotes posts/YYYY-MM-DD-weeknotes.md` + +**Sections** (all optional—skip any that don't apply): + +- Shipped — projects, features, fixes, accomplishments +- Read — books, articles, interesting finds +- Played — games, experiments, fun projects +- Cooked — recipes, Random Recipe Project work +- Noticed — observations from garden, neighborhood, life +- Thinking About — ideas brewing, problems being chewed on +- What's Next — upcoming plans and goals + +**Voice for weeknotes**: Brief, punchy, concrete. Less polished than regular posts. Okay to be fragmentary. The goal is marking time and noticing patterns, not crafting essays. + ### Menu Structure The site has four menu groups configured in `config.toml`: - **main**: Home and Tags navigation diff --git a/archetypes/weeknotes.md b/archetypes/weeknotes.md new file mode 100644 index 00000000..5dfe10f9 --- /dev/null +++ b/archetypes/weeknotes.md @@ -0,0 +1,37 @@ +--- +title: "Weeknotes: {{ dateFormat "January 2, 2006" .Date }}" +date: {{ .Date }} +draft: true +tags: + - weeknotes +--- + +_[One sentence capturing the week's vibe]_ + +## Shipped + +- + +## Read + +- + +## Played + +- + +## Cooked + +- + +## Noticed + +- + +## Thinking About + +- + +## What's Next + +- diff --git a/content/weeknotes.md b/content/weeknotes.md new file mode 100644 index 00000000..dc9ba000 --- /dev/null +++ b/content/weeknotes.md @@ -0,0 +1,11 @@ +--- +title: Weeknotes +aliases: + - /weeknotes/ +--- + +Weeknotes are short, personal reflections on the week—what I shipped, read, played, cooked, noticed, and thought about. They're a way to mark time and notice patterns. + +The format comes from the [weeknotes movement](https://indieweb.org/weeknotes), which grew out of the UK digital government community and spread through personal blogs. [Giles Turnbull's guide](https://doingweeknotes.com/) and [Tracy Durnell's reflections](https://tracydurnell.com/2024/07/30/using-personal-weeknotes-as-a-tool-for-attention/) shaped my approach. + +Browse all weeknotes: [/tags/weeknotes](/tags/weeknotes/)