Add Popdog roundup style guidance

This commit is contained in:
2026-05-11 16:52:13 +01:00
parent 7fed91d98b
commit 500cbb8f70

View File

@@ -14,9 +14,11 @@ Obsidian CLI requires the desktop app to be running; if it is not running, the f
Use this format in `Work/Popdog/_Todo.md`: Use this format in `Work/Popdog/_Todo.md`:
```markdown ```markdown
- [ ] ==**High**== Task Title - [ ] ==**High**== Task Title (Catwalk PR#)
- [ ] Sub task/portion of task - [ ] Sub task/portion of task
- [ ] **Medium** Task Title - [ ] **Medium** Task Title (Harvester PR#)
- [ ] Sub task/portion of task
- [ ] **Medium** Task Title (Harvester PR#, Catwalk PR#)
- [ ] Sub task/portion of task - [ ] Sub task/portion of task
``` ```
@@ -26,11 +28,58 @@ When a task is verified complete:
- Mark it complete in `_Todo.md`. - Mark it complete in `_Todo.md`.
- Roll it into the daily roundup note named `YYYY-MM-DD.md`. - Roll it into the daily roundup note named `YYYY-MM-DD.md`.
- Daily roundups are delivered to the whole company, a mix of both devs and non-devs. The roundup should be accessible to both.
- Personal notes can be added at the bottom of the document under a --- divider, this won't be sent as part of the roundup.
- Daily roundups are bulleted, not checkboxes.
- Include the PR and repo next to completed work when known. - Include the PR and repo next to completed work when known.
```markdown ```markdown
- [x] Task Title (PR# - Catwalk) - Task Title (Catwalk PR#)
- [x] Task Title (PR# - Harvester) - Task Title (Harvester PR#)
- Task Title (Catwalk PR#, Harvester PR#)
```
## Popdog Daily Roundup Style
Daily roundups should sound like Harry's practical engineering update, not a polished changelog.
- Start new daily notes with `# Monday`, `# Tuesday`, etc.
- Use short bullets, usually 2-5 public bullets for the day.
- Group by repo only when useful: `**Catwalk**`, `**Harvester**`, `**Both**`.
- Prefer plain English over release-note phrasing.
- Explain the actual user/business impact, not just the implementation.
- Include technical detail when it explains why something mattered.
- Be direct about uncertainty: `seems`, `as far as I can tell`, `likely`, `should`, `WIP`, `not deployed`.
- Mention what is complete, what is in review, and what is still being investigated.
- Keep a casual tone where natural: `dodgy`, `hammering the database`, `slow as shit`, `cos it was bugging me` match the existing notes.
- Avoid sounding too neat, corporate, or exhaustive.
- Do not over-summarise into abstract outcomes like `improved reliability` unless followed by the concrete thing that changed.
- Use contractions naturally: `we're`, `I've`, `it'll`, `don't`.
- Use lowercase repo/product names when that is how Harry usually writes them: `harvester`, `catwalk`, `youtube`, `twitch`, unless at the start of a formal heading.
- Keep PR numbers when known, but do not make the note revolve around PR metadata.
- Include screenshots inline after the relevant bullet when useful.
- Put personal/internal scratch notes below `---` so they are not part of the company-facing roundup.
Preferred pattern:
```markdown
- [Thing] now [does the useful behaviour]. [Short reason/context if needed].
```
Good examples:
```markdown
- Catwalk now fetches twitch vod and clip data from Harvester
- Game names are now collated when filtering, you can search Pokemon and it'll pick up accented characters no problem
- Harvester Sync Jobs now time out after 10 minutes. When catwalk was deployed a job would get stuck in the "running" state and wouldn't get timed out for 60 minutes.
```
Avoid abstract agent-changelog phrasing:
```markdown
- Improved Harvester operational resilience by implementing a stricter execution timeout policy for synchronization workloads.
- Enhanced game discovery by normalizing multilingual filter behaviour.
- Continued progress on Discover page performance optimizations.
``` ```
## Agent Workflow ## Agent Workflow