Skip to content
github-actions[bot] edited this page Nov 12, 2026 · 18 revisions

Blacksmith Organization System

release revision checks GitHub release npm@next node docs wiki license bundlephobia socket.dev Snyk npmgraph nightly github.com source gitea.com mirror gitlab.com mirror bitbucket.org mirror sr.ht mirror

************************************
  Project in R tier scope "ANUBIS"
     ______    _____    _____
     | ___ \  |  _  |  /  ___|
     | |_/ /  | | | |  \ `--.
     | ___ \  | | | |   `--. \
     | |_/ /  \ \_/ /  /\__/ /
     \____(_)  \___(_) \____(_)

    By Sett Sarverott @ 2019-2024
************************************

The Blacksmith Organization System (BOS) keeps a programmer's work in one shape on every machine: a workshop (__WORKSHOP) with its areas, scopes and projects, built, watched and inspected by code, and a craft loop that moves every change from a contributor's branch to a release and versions it. This is the documentation of its core, the npm package blacksmith-organization-system.

Start

Parts

Part What is in it
Glossary every element of a workshop, one page each: what it is, why, where. Meaning comes before code
Architecture how the core's code holds it: models, interfaces, bridges
Devlog where the core is going and the talk with the owner: vision, roadmap, TODO, questions, orders
Changelog what happened, phase by phase, the owner's words kept as written
For agents what the AI agents working here found and concluded (they write, people read)

Key ideas

  • Workshop: .BOS, devarmory, forge, craftbook, archive.
  • Scope and project: forge/<scope>/<project>.
  • Craft loop: dev/<name> → development → revision → testing → releasing → master.
  • Versions: semver vX.Y.Z for projects, GRIH vG.R.I.H for scopes.

This wiki is generated from docs/ of version 1.14.1; edit the pages there. The same documentation, searchable: https://blacksmith-organization-system.readthedocs.io/.

Clone this wiki locally