d2da71e53a
- 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
100 lines
2.5 KiB
Markdown
100 lines
2.5 KiB
Markdown
# Beyond the Prompt: Lessons from Building with Claude Code
|
|
|
|
A presentation by **[Scott Scoble](https://scott.scoble.me)** about using Skills and Subagents to guide AI-assisted development, demonstrated through the FLUO project's FluoDSL sandboxing decision.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Clone the repository
|
|
git clone https://github.com/yourusername/beyond-the-prompt.git
|
|
cd beyond-the-prompt
|
|
|
|
# Start the presentation (requires Nix)
|
|
nix run .#present
|
|
```
|
|
|
|
Open http://localhost:8000 in your browser.
|
|
|
|
## Prerequisites
|
|
|
|
- [Nix](https://nixos.org/download.html) package manager with flakes enabled
|
|
|
|
## Commands
|
|
|
|
### Run Presentation Only
|
|
|
|
```bash
|
|
nix run .#present
|
|
```
|
|
|
|
Serves the presentation at http://localhost:8000
|
|
|
|
### Run Full Demo
|
|
|
|
```bash
|
|
nix run .#demo
|
|
```
|
|
|
|
Serves:
|
|
- Presentation at http://localhost:8000
|
|
- Conversation viewer at http://localhost:8001 (if available)
|
|
|
|
### Development Mode
|
|
|
|
```bash
|
|
# Enter development shell with all tools
|
|
nix develop
|
|
|
|
# Start presentation server with live reload
|
|
caddy file-server --root ./presentation --listen :8000
|
|
```
|
|
|
|
## Presenter Mode
|
|
|
|
Press `P` during the presentation to toggle presenter mode with speaker notes and timing.
|
|
|
|
Press `C` to clone the slideshow for dual-screen presentation.
|
|
|
|
## Key Keyboard Shortcuts
|
|
|
|
- `→` / `Space` - Next slide
|
|
- `←` - Previous slide
|
|
- `P` - Toggle presenter mode
|
|
- `C` - Clone slideshow
|
|
- `F` - Toggle fullscreen
|
|
- `?` - Show help
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
.
|
|
├── flake.nix # Nix flake with apps and devShell
|
|
├── README.md # This file
|
|
├── CLAUDE.md # Instructions for Claude Code
|
|
├── docs/
|
|
│ ├── adr/ # Architecture Decision Records
|
|
│ └── demo/ # Demo materials
|
|
└── presentation/
|
|
├── index.html # Reveal.js presentation
|
|
├── slides.md # Presentation content
|
|
├── assets/ # Images, CSS, themes
|
|
└── vendor/ # Vendored dependencies
|
|
```
|
|
|
|
## Content
|
|
|
|
This presentation covers:
|
|
|
|
1. **Context Window Economics** - Progressive disclosure and token efficiency
|
|
2. **Skills + Subagents Pattern** - HOW to implement vs SHOULD we build
|
|
3. **Preventing Waste** - Evaluation before execution
|
|
|
|
## Learn More
|
|
|
|
- FLUO Project: https://github.com/fluohq/fluo
|
|
- See `.skills/` and `.subagents/` directories in FLUO for implementation examples
|
|
- Read ADRs in `docs/adr/` for architectural context
|
|
|
|
## License
|
|
|
|
MIT License - see [LICENSE](LICENSE) file for details
|