culture-nodes
A workflow front and framework for Culture. Composes mesh agents and their verbs into node-based workflows — define a graph of nodes, run it across the Culture mesh, and inspect what each node did.
Every node has a contract. Every result has evidence.
Status
The product — Culture Nodes, a durable, ledger-native workflow orchestrator for agents, code, services, and people — is fully specified but not yet implemented:
docs/initial-design/culture-nodes-prd-spec.md— the PRD and technical specification: graph model, contract-first nodes, the Devague-derived work ledger (proposed / confirmed / observed / derived authority), the headspace-cli code-runner boundary, runtime architecture, and delivery phases.docs/initial-design/culture-nodes-implementation-issue.md— the Phase 0/1 implementation issue (contracts + compiler, then a durable vertical slice).
What exists today is the repo's mesh-agent baseline, scaffolded from
culture-agent-template:
- An agent-first CLI (installed as
nodes) cited from teken — the runtime package has no third-party dependencies. - A mesh identity —
culture.yaml(suffix: culture-nodes,backend: colleague) with the matching resident prompt file (AGENTS.colleague.md). - The vendored guildmaster/devague skill kit under
.claude/skills/, cite-don't-import. Seedocs/skill-sources.md. - A build + deploy baseline — pytest, lint, the agent-first rubric gate, and PyPI Trusted Publishing wired into GitHub Actions.
Quickstart
uv sync
uv run pytest -n auto # run the test suite
uv run nodes whoami # identity from culture.yaml
uv run nodes learn # self-teaching prompt (add --json)
uv run teken cli doctor . --strict # the agent-first rubric gate CI runs
CLI
| Verb | What it does |
|---|---|
nodes whoami |
Report this agent's nick, version, backend, and model from culture.yaml. |
nodes learn |
Print a structured self-teaching prompt. |
nodes explain <path> |
Markdown docs for any noun/verb path. |
nodes overview |
Read-only descriptive snapshot of the agent. |
nodes doctor |
Check the agent-identity invariants (prompt-file-present, backend-consistency, skills-present). |
nodes cli overview |
Describe the CLI surface itself. |
Every command supports --json. Results go to stdout, errors/diagnostics to
stderr (never mixed). Exit codes: 0 success, 1 user error, 2 environment
error, 3+ reserved.
Contributing
See CLAUDE.md for the working conventions: the design ground
rules distilled from the PRD, the version-bump-every-PR rule, the cicd PR
lane, and the vendored-skills policy.
License
Apache 2.0 — see LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file culture_nodes-0.6.2.tar.gz.
File metadata
- Download URL: culture_nodes-0.6.2.tar.gz
- Upload date:
- Size: 186.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1103e3b99b125332f44ed157e6eb46cca54887238fa51cda0617ac4a006495ac
|
|
| MD5 |
b88d7712bf79bce268aaa5331ef1a6a3
|
|
| BLAKE2b-256 |
29b363ebb2c74ed18f80ed79140146adc82cdbf3663f266a3db1a5cb03331ab0
|
File details
Details for the file culture_nodes-0.6.2-py3-none-any.whl.
File metadata
- Download URL: culture_nodes-0.6.2-py3-none-any.whl
- Upload date:
- Size: 22.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b867e442ef9c18861f4804143ada2f0aebdbdbe570bf9f012651cb2c0efea61
|
|
| MD5 |
b370bcd5bac89ac693978fd93049dd2f
|
|
| BLAKE2b-256 |
dfa89da4d8bb9d9a0800881629c2d259d5a24915881d3fc044f4054b8d6b5680
|
