Skip to content

Instantly share code, notes, and snippets.

View rianvdm's full-sized avatar

Rian van der Merwe rianvdm

View GitHub Profile
@rianvdm
rianvdm / See.md
Last active January 7, 2026 04:07
Comments: seeing like a software company

These are my raw comments, as someone who has spent 50/50 of my 20+ year career in small and large companies. So I think I have a good understanding of both.

Seeing like a software company

Author: zdw

URL: https://www.seangoedecke.com/seeing-like-a-software-company/

  • By “legible”, I mean work that is predictable, well-estimated, has a paper trail, and doesn’t depend on any contingent factors (like the availability of specific people). Quarterly planning, OKRs, and Jira all exist to make work legible. Illegible work is everything else: asking for and giving favors, using tacit knowledge that isn’t or can’t be written down, fitting in unscheduled changes, and drawing on interpersonal relationships. As I’ll argue, tech companies need to support both of these kinds of work.
    • Note: What does “contingent factors” mean here? Not defined so sounds smart but no idea what it means in practice.
#!/usr/bin/env python3
"""
Calendar briefing generator.
Usage:
python scripts/calendar_briefing.py # Tomorrow
python scripts/calendar_briefing.py --today # Today
python scripts/calendar_briefing.py --days 3 # Next 3 days
python scripts/calendar_briefing.py --week # Next 7 days
python scripts/calendar_briefing.py --save # Save to work/cloudflare/briefings/
@rianvdm
rianvdm / product-debate.md
Last active January 1, 2026 19:44
Product Debate: Pro vs. Skeptic

Product Debate: Pro vs. Skeptic

You are a simulator for a high-stakes product strategy debate. Your goal is to stress-test a product idea by simulating two opposing viewpoints and then synthesizing a path forward.

The Agents

1. The Visionary (Pro)

  • Role: Chief Product Officer / Founder mindset.
  • Focus: User value, market potential, innovation, "magic moments," growth loops.
  • Personality: Optimistic, creative, persuasive. Believes anything is possible with the right execution.
@rianvdm
rianvdm / brainstorming-planning.md
Last active December 23, 2025 10:21
Project brainstorming and spec creation

Project brainstorming and spec creation

Build ideas from scratch through guided discovery, then produce developer-ready specs and implementation prompts.


When to Use

  • Starting a new side project from a rough idea
  • Need structured thinking before jumping into code
@rianvdm
rianvdm / AGENTS.md
Created December 20, 2025 16:17 — forked from elithrar/AGENTS.md
a very helpful AGENTS.md! copy to the root of your repos - modern coding agents will use it. happy coding!

AGENTS.md

Instructions for AI coding agents working in this repository.

Decision-making

  • When possible, defer decisions to larger groups. Ensure all stakeholders have an opportunity to weigh in before proceeding.
  • Demand precision. Insist on clarifying ambiguities and edge cases before beginning any implementation.
  • Reopen previously settled matters if new participants join or if conditions have changed, even slightly.
  • Raise questions about whether the current approach aligns with long-term strategy. Suggest forming a working group if uncertainty remains.
@rianvdm
rianvdm / amazon-s3-auto-upload
Created October 6, 2014 17:55
An automated image upload workflow for Amazon S3
# For more info, see http://www.elezea.com/2014/07/automatic-upload-amazon-s3/
import boto
from boto.s3.connection import S3Connection
import os
import sys
import urllib
from datetime import date, datetime
import subprocess