Skip to content

v0.2.0 - #32

Merged
Brian Krabach (bkrabach) merged 12 commits into
microsoft:v0.2.0from
payneio:papayne/modal
Sep 29, 2025
Merged

v0.2.0#32
Brian Krabach (bkrabach) merged 12 commits into
microsoft:v0.2.0from
payneio:papayne/modal

Conversation

@payneio

@payneioPaul Payne (payneio) commented Sep 29, 2025

Copy link
Copy Markdown
Contributor

Four big changes.

  1. This changes the model from "work on projects in amplifier" to "bring amplifier to your projects".
  2. Splits "core" amplifier out of configuration by creating an "official directory" of amplifier resources.
  3. Also, you can have multiple different "modes" of amplifier... the one we've been using has been added as a "python-coder" mode, but now modes can be custom and community-contributed.
  4. Configuration has been migrated from .env to .amplifier/config.yaml.
  • This introduces an amplifier cli that allows initializing amplifier in an existing project directory and selecting which mode you want amplifier to be in.
  • A mode is a set of (.claude) subagents, hooks, commands, tools, and context files that go together.

Migrating from v0.1.0

  • Pull amplifier repo.
  • Rename your .claude directory: mv .claude .claude.bak.
  • Also: mv CLAUDE.md CLAUDE.md.bak && mv AGENTS.md AGENTS.md.bak
  • Make sure uv env is activated: source .venv/bin/activate
  • Install the amplifier script: uv pip install -e .
  • Initialize 0.2.0: amplifier init. This creates the .amplifier directory in your project.
  • If you customized any of the config in .env update your values in the new config file at .amplifier/config.yaml. Note: You can still override config.yaml config with env vars in the form of AMPLIFIER__NESTED__CONFIG_VALUE type keys (they map to what is in the config.yaml).
  • Until we get the directory into main, you won't be able to git it, so until then, update your directory in .amplifier/config.yaml to be the path to the directory folder, and then run: amplifier fetch-directory to have the directory cached/copied into your .amplifier directory.
  • Change to python coder mode: amplifier mode set python-coder. This will re-create your .claude directory.

Other things to know.

  • worktree and transcript tools have been moved out of the Makefile and put in the amplifier cli (see amplifier --help).
  • tools have been moved into the directory and, after fetching, can now be called with uv run python .amplifier/directory/tools/<tool.py>
  • All configuration has been

@payneioPaul Payne (payneio) changed the title papayne/modalv0.2.0Sep 29, 2025
@bkrabach
Brian Krabach (bkrabach) merged commit 4570361 into microsoft:v0.2.0Sep 29, 2025
1 check passed
Michael J. Jabbour (michaeljabbour) added a commit to michaeljabbour/amplifier that referenced this pull request Sep 30, 2025
Complete comprehensive technical specification library with all 44 principles:
**People (6 specs)**
- #1 Small AI-first working groups
- #2 Strategic human touchpoints only
- #3 Prompt engineering as core skill
- microsoft#4 Test-based verification over code review
- microsoft#5 Conversation-driven development
- microsoft#6 Human escape hatches always available
**Process (13 specs)**
- microsoft#7 Regenerate, don't edit
- microsoft#8 Contract-first everything
- microsoft#9 Tests as the quality gate
- microsoft#10 Git as safety net
- microsoft#11 Continuous validation with fast feedback
- microsoft#12 Incremental processing as default
- microsoft#13 Parallel exploration by default
- microsoft#14 Context management as discipline
- microsoft#15 Git-based everything
- microsoft#16 Docs define, not describe
- microsoft#17 Prompt versioning and testing
- microsoft#18 Contract evolution with migration paths
- microsoft#19 Cost and token budgeting
**Technology (18 specs)**
- microsoft#20 Self-modifying AI-first codebase
- microsoft#21 Limited and domain-specific by design
- microsoft#22 Layered virtualization
- microsoft#23 Protected self-healing kernel
- microsoft#24 Long-running agent processes
- microsoft#25 Simple interfaces by design
- microsoft#26 Stateless by default
- microsoft#27 Disposable components everywhere
- microsoft#28 CLI-first design
- microsoft#29 Tool ecosystems as extensions
- microsoft#30 Observability baked in
- microsoft#31 Idempotency by design (reference)
- microsoft#32 Error recovery patterns built in
- microsoft#33 Graceful degradation by design
- microsoft#34 Feature flags as deployment strategy
- microsoft#35 Least-privilege automation
- microsoft#36 Dependency pinning and security scanning
- microsoft#37 Declarative over imperative
**Governance (7 specs)**
- microsoft#38 Access control and compliance
- microsoft#39 Metrics and evaluation everywhere
- microsoft#40 Knowledge stewardship and institutional memory
- microsoft#41 Adaptive sandboxing with explicit approvals
- microsoft#42 Data governance and privacy controls
- microsoft#43 Model lifecycle management
- microsoft#44 Self-serve recovery with known-good snapshots
Each specification includes:
- Plain-language definition
- AI-first development rationale
- 4-6 implementation approaches
- 5 good/bad example pairs with working code
- 6 related principles with relationships
- 7 common pitfalls with examples
- Tools organized by category
- 12 actionable checklist items
Statistics:
- 44 specifications totaling ~10,000+ lines
- 220+ good/bad code example pairs
- 240+ implementation approaches
- 300+ documented anti-patterns
- 500+ tools and frameworks
- 250+ cross-principle relationships
Created through parallel AI agent execution demonstrating
Principle microsoft#13 (Parallel Exploration by Default).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Joi Ito (Joi) pushed a commit to Joi/amplifier that referenced this pull request Nov 9, 2025
* Amplifier modes
* Change .amp to .amplifier.
* Make dot-amplifier template
* Moves amplifier directory out of library and allows fetch from git or local dir.
* Delete .claude dir.
* Ignore .claude now that we are fully managed.
* Move tools into directory.
* Moves worktree tools from make to amplifier cli.
* Move make transcript commands to amplifier cli.
* Updates config to all pull from config.yaml with env var overrides.
* Contexts fix.
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@payneio@bkrabach