0.0
There's a lot of open issues
A dry-cli CLI for the Architect Loop: iterations, briefs, freezes, verdicts, lane worktrees, and headless pi dispatch โ€” the judgment loop that runs inside space-cadet's task-scoped workspaces. Depends on the space-cadet gem for the spaces substrate (hard).
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 6.0
~> 13.0

Runtime

 Project Readme

Space Architect ๐Ÿš€

Gem Version

The Architect Loop โ€” structured judgment-and-build cycles for humans and their agents! โœจ๐Ÿ›ฐ๏ธ

space-architect is the gem behind the Architect Loop: a structured judgment-and-build cycle in which a strong reasoning model (the architect) plans, freezes acceptance criteria, and judges the work of a fleet of headless AI builders โ€” one per lane, each in its own git worktree. The loop runs inside task-scoped spaces: directories that hold repos, notes, and artifacts under one obvious filesystem root. Nothing lives only in a chat window โ€” every decision, spec, and verdict is committed to the space repo.

It installs one executable, architect. The spaces substrate is a sibling gem:

Gem Dependency What it provides
space-cadet hard The spaces substrate (Space::Core): create, manage & containerize task-scoped workspaces โ€” the space binary โ€” plus the copy-on-write evergreen-checkout substrate repos provision from

Installation ๐Ÿ“ฆ

gem install space-architect

The gem installs one executable: architect. ๐ŸŽ€ (Or add gem "space-architect" to your Gemfile and bundle install.)

Upgrading from the 8.x monolith? Uninstall space-architect 8.x first โ€” its space/src executables collide with the ones the new gems ship โ€” see the upgrade guide.

60-second start ๐ŸŽ€

Run one full loop iteration in a scratch space โ€” the tutorial walks it end to end:

space init                          # create the XDG config + state files (space-cadet gem)
space new "Docsmith Tutorial"       # blast off a new space ๐Ÿš€
cd ~/architect/spaces/<id>-docsmith-tutorial
architect init                      # scaffold ARCHITECT.md + the space.yaml project: block

From there the loop is: architect new โ†’ architect section โ€ฆ โ†’ architect freeze โ†’ architect dispatch โ†’ architect gate โ†’ architect integrate. The tutorial runs every step on a scratch repo.

The four quadrants ๐Ÿงญ

Quadrant Read it when youโ€ฆ Start here
Tutorials โ€” learning-oriented are new and want a guided journey docs/tutorials
How-to guides โ€” goal-oriented have a specific task to do docs/how-to
Reference โ€” information-oriented need a fact about a command, flag, or file docs/reference
Explanation โ€” understanding-oriented want the why behind the design docs/explanation

Development ๐Ÿ› ๏ธ

bundle install
bundle exec rake test       # the full minitest suite
bundle exec rake build      # build the gem into pkg/
bundle exec rake install    # build + install into your user gem home

Bug reports and pull requests are welcome on GitHub at https://github.com/jetpks/space-architect. Available as open source under the MIT License.


Made with ๐Ÿ’– and fibers ๐Ÿงต by Eric