Initial commit: Beyond the Prompt workshop presentation by Scott Scoble
- Reveal.js presentation on Skills and Subagents pattern - Nix flake with Caddy-based HTTP server and process-compose orchestration - ADRs documenting architectural decisions - Skills for AI implementation guidance - Full Scott Scoble author attribution in README
This commit is contained in:
Scott Scoble
commit
d2da71e53a
33 changed files with 4865 additions and 0 deletions
223
flake.nix
Normal file
223
flake.nix
Normal file
|
|
@ -0,0 +1,223 @@
|
|||
{
|
||||
description = "Beyond the Prompt: Lessons from Building with Claude Code";
|
||||
|
||||
inputs = {
|
||||
nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
|
||||
};
|
||||
|
||||
outputs = { self, nixpkgs }:
|
||||
let
|
||||
# Systems to support
|
||||
supportedSystems = [
|
||||
"x86_64-linux"
|
||||
"aarch64-linux"
|
||||
"x86_64-darwin"
|
||||
"aarch64-darwin"
|
||||
];
|
||||
|
||||
# Helper function to generate outputs for all systems
|
||||
forAllSystems = f: nixpkgs.lib.genAttrs supportedSystems (system: f system (import nixpkgs { inherit system; }));
|
||||
|
||||
# Generate Caddyfile for presentation
|
||||
makeCaddyConfig = pkgs: port: root: pkgs.writeText "Caddyfile" ''
|
||||
:${toString port} {
|
||||
root * ${root}
|
||||
file_server browse
|
||||
encode gzip
|
||||
log {
|
||||
output stdout
|
||||
format console
|
||||
}
|
||||
}
|
||||
'';
|
||||
|
||||
# Generate process-compose config
|
||||
makeProcessComposeConfig = pkgs: processes: pkgs.writeText "process-compose.yaml" (
|
||||
builtins.toJSON {
|
||||
version = "0.5";
|
||||
inherit processes;
|
||||
}
|
||||
);
|
||||
|
||||
in
|
||||
{
|
||||
# Apps for each system
|
||||
apps = forAllSystems (system: pkgs: {
|
||||
# Presentation server
|
||||
present = {
|
||||
type = "app";
|
||||
program = "${pkgs.writeScript "present" ''
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
|
||||
# Use current working directory for development
|
||||
PRESENTATION_ROOT="$PWD/presentation"
|
||||
|
||||
if [ ! -d "$PRESENTATION_ROOT" ]; then
|
||||
echo "Error: presentation/ directory not found in current directory"
|
||||
echo "Please run this command from the project root"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Generate Caddyfile at runtime
|
||||
CADDY_CONFIG=$(mktemp)
|
||||
trap "rm -f $CADDY_CONFIG" EXIT
|
||||
cat > "$CADDY_CONFIG" <<EOF
|
||||
:8000 {
|
||||
root * $PRESENTATION_ROOT
|
||||
file_server browse
|
||||
encode gzip
|
||||
log {
|
||||
output stdout
|
||||
format console
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
# Generate process-compose config at runtime
|
||||
COMPOSE_CONFIG=$(mktemp)
|
||||
trap "rm -f $COMPOSE_CONFIG" EXIT
|
||||
cat > "$COMPOSE_CONFIG" <<EOF
|
||||
{
|
||||
"version": "0.5",
|
||||
"processes": {
|
||||
"presentation": {
|
||||
"command": "${pkgs.caddy}/bin/caddy run --config $CADDY_CONFIG --adapter caddyfile",
|
||||
"readiness_probe": {
|
||||
"http_get": {
|
||||
"host": "localhost",
|
||||
"port": 8000
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
echo "Starting presentation server on http://localhost:8000"
|
||||
exec ${pkgs.process-compose}/bin/process-compose up -f "$COMPOSE_CONFIG" --tui=false
|
||||
''}";
|
||||
};
|
||||
|
||||
# Demo: serves both presentation and conversation transcript
|
||||
demo = {
|
||||
type = "app";
|
||||
program = "${pkgs.writeScript "demo" ''
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
|
||||
# Use current working directory for development
|
||||
PRESENTATION_ROOT="$PWD/presentation"
|
||||
DEMO_ROOT="$PWD/docs/demo"
|
||||
|
||||
if [ ! -d "$PRESENTATION_ROOT" ]; then
|
||||
echo "Error: presentation/ directory not found in current directory"
|
||||
echo "Please run this command from the project root"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ ! -d "$DEMO_ROOT" ]; then
|
||||
echo "Error: docs/demo/ directory not found in current directory"
|
||||
echo "Please run this command from the project root"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Generate Caddyfiles at runtime
|
||||
PRESENTATION_CADDY_CONFIG=$(mktemp)
|
||||
DEMO_CADDY_CONFIG=$(mktemp)
|
||||
COMPOSE_CONFIG=$(mktemp)
|
||||
trap "rm -f $PRESENTATION_CADDY_CONFIG $DEMO_CADDY_CONFIG $COMPOSE_CONFIG" EXIT
|
||||
|
||||
cat > "$PRESENTATION_CADDY_CONFIG" <<EOF
|
||||
:8000 {
|
||||
root * $PRESENTATION_ROOT
|
||||
file_server browse
|
||||
encode gzip
|
||||
log {
|
||||
output stdout
|
||||
format console
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
cat > "$DEMO_CADDY_CONFIG" <<EOF
|
||||
:8001 {
|
||||
root * $DEMO_ROOT
|
||||
file_server browse
|
||||
encode gzip
|
||||
log {
|
||||
output stdout
|
||||
format console
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
# Generate process-compose config at runtime
|
||||
cat > "$COMPOSE_CONFIG" <<EOF
|
||||
{
|
||||
"version": "0.5",
|
||||
"processes": {
|
||||
"presentation": {
|
||||
"command": "${pkgs.caddy}/bin/caddy run --config $PRESENTATION_CADDY_CONFIG --adapter caddyfile",
|
||||
"readiness_probe": {
|
||||
"http_get": {
|
||||
"host": "localhost",
|
||||
"port": 8000
|
||||
}
|
||||
}
|
||||
},
|
||||
"conversation": {
|
||||
"command": "${pkgs.caddy}/bin/caddy run --config $DEMO_CADDY_CONFIG --adapter caddyfile",
|
||||
"readiness_probe": {
|
||||
"http_get": {
|
||||
"host": "localhost",
|
||||
"port": 8001
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
echo "Starting demo environment:"
|
||||
echo " - Presentation: http://localhost:8000"
|
||||
echo " - Conversation: http://localhost:8001"
|
||||
exec ${pkgs.process-compose}/bin/process-compose up -f "$COMPOSE_CONFIG" --tui=false
|
||||
''}";
|
||||
};
|
||||
});
|
||||
|
||||
# Development shells
|
||||
devShells = forAllSystems (system: pkgs: {
|
||||
default = pkgs.mkShell {
|
||||
buildInputs = [
|
||||
pkgs.caddy
|
||||
pkgs.process-compose
|
||||
pkgs.bash
|
||||
# Optional tools (uncomment as needed)
|
||||
# pkgs.nodejs
|
||||
# pkgs.asciinema
|
||||
# pkgs.bat
|
||||
# pkgs.alejandra # Nix formatter
|
||||
];
|
||||
|
||||
shellHook = ''
|
||||
echo "Welcome to 'Beyond the Prompt' development environment!"
|
||||
echo ""
|
||||
echo "Available commands:"
|
||||
echo " nix run .#present - Start presentation server (http://localhost:8000)"
|
||||
echo " nix run .#demo - Start demo environment (presentation + conversation)"
|
||||
echo ""
|
||||
echo "Direct development (with live reload):"
|
||||
echo " caddy file-server --root ./presentation --listen :8000"
|
||||
echo ""
|
||||
echo "Project structure:"
|
||||
echo " docs/adr/ - Architecture Decision Records"
|
||||
echo " presentation/ - Reveal.js presentation files"
|
||||
echo " docs/demo/ - Conversation transcript and demo materials"
|
||||
echo ""
|
||||
'';
|
||||
};
|
||||
});
|
||||
};
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue