Skip to content

Instantly share code, notes, and snippets.

@shykes
shykes / module-manifest-v2-remaining-issues.md
Last active September 2, 2026 19:54
Dagger Module Manifest v2: remaining design issues

Module Manifest v2: Review Status

Review baseline: future/module-manifest-v2.md at fa99a6039.

No open item from the previous engine-side review remains.

Previous issue Resolution
Entrypoint construction Each driver has an explicit construction rule.
Call routing Constructors use the owning type and an empty function name. Object functions use their original names.
@shykes
shykes / module-max.md
Created August 24, 2026 23:09
1.0 UX. Variation 'module-max'
@shykes
shykes / pr-13608-golang-vcs-briefing.md
Created July 30, 2026 10:47
Why PR #13608 golang:test-all fails, why it fails now, and what the failure teaches us about recursive Dagger workspaces

When a workspace marker becomes a broken Git repository

Root-cause briefing for golang:test-all on dagger/dagger#13608

This briefing answers two related questions:

  1. Why is the check failing?
  2. Why did it start failing now?

The short answer is:

@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)