Skip to content

Instantly share code, notes, and snippets.

@shykes
shykes / versions-toml-proposal.md
Created May 30, 2026 05:39
Proposal: versions.toml as source of truth for intended versions

Versions in versions.toml

Problem

To build and release Dagger, we compute and inject a version string. We do this in a way that is slow, breaks separation of concerns, and increases complexity and bugs.

Specifically, the current implementation:

  • Fetches all Git tags on each build, making it slower and vulnerable to GitHub outages.
  • Walks Git tags to compute the version, which is slow and gets worse as history grows.
@shykes
shykes / SKILL.md
Created May 30, 2026 05:37
Bullet style — a writing style guide for technical bulleted critique
Error in user YAML: (<unknown>): mapping values are not allowed in this context at line 2 column 279
---
name: bullet-style
description: Write tight, parallel-structured bullets for technical problem statements, RFC critique sections, GitHub discussion intros, and design doc analysis. Use when drafting or editing prose where bullets describe how a system behaves and why it's problematic. Triggers on: problem statement, RFC, design doc critique, discussion intro, bulleted analysis, "what's wrong with X."
---

Bullet style

A distilled style guide for technical bulleted critique — problem statements, RFC sections, GitHub discussion intros, anything where a bulleted list describes how a system works and why it's bad.

Markers in the rules below: ✅ explicitly taught through edits; ⚠️ observed in the user's drafts and confirmed when surfaced.

@shykes
shykes / discord-thread-sync.md
Created May 29, 2026 23:51
Discord thread SQLite sync CLI spec

Discord Thread Sync CLI

Purpose

Build a standalone CLI that mirrors Discord thread state into SQLite.

The tool must not depend on discordex internals. It should be usable by discordex, an admin script, or any other consumer as an external process that owns its own config, Discord connection, database, migrations, and inspection commands.

Handoff: dagger check + Cloud Results

Context

Yves (eunomie) has an open PR — dagger/dagger#13130 — adding dagger module-checks, a new experimental command that fetches check/trace results from Dagger Cloud and renders them in the CLI. It works, but it's a separate command with its own rendering pipeline, disconnected from the existing dagger check.

The design direction we landed on

Don't add a new command. Make dagger check smarter.

@shykes
shykes / container-volatile-variables.md
Created May 13, 2026 23:46
Dagger Design: Part 1 - Container Volatile Variables
@shykes
shykes / tracking-final.md
Created April 1, 2026 11:50
ARCHIVE: Workspace Artifacts Tracking
@shykes
shykes / artifact-addresses-gist.md
Created April 1, 2026 11:38
ARCHIVE: Do We Need Artifact Addresses? (analysis)
@shykes
shykes / artifacts-on-collections-gist.md
Created April 1, 2026 11:33
ARCHIVE: Rebasing Artifacts onto Standalone Collections (design working notes)

ARCHIVE: Rebasing Artifacts onto Standalone Collections

Working notes from the design session that produced the Modules v2 split docs. Covers the Artifacts API schema evolution, Execution Plans, filter model, Action type, and staged changes to collections. Content has been absorbed into hack/designs/modules-v2/ on the modules-v2 branch of dagger/dagger.

See: https://github.com/dagger/dagger/tree/modules-v2/hack/designs/modules-v2


@shykes
shykes / workspace-artifacts-gist.md
Created April 1, 2026 11:25
ARCHIVE: Workspace Artifacts Design (pre-Modules v2 split)

ARCHIVE: Workspace Artifacts Design (Pre-Modules v2)

This document is archived. It was the original integrated design covering collections, addresses, verbs, plans, and provenance as one system. It has since been superseded by the split design docs in hack/designs/modules-v2/ on the modules-v2 branch of dagger/dagger.

See: https://github.com/dagger/dagger/tree/modules-v2/hack/designs/modules-v2


@shykes
shykes / lockfile-codex-proposal.md
Last active April 1, 2026 00:54
Dagger Design: Lockfile live state proposal

Lockfile Session-State Proposal

This is a pure session-state design, not a hybrid DagQL/session design.

It intentionally picks one of the two mutually exclusive approaches:

  1. do it through DagQL
  2. do it through session state

This proposal picks session state.