Skip to main content

terrastep

TerraParse Standardized Enhancement Proposals (terrastep) is a method and format by which to communicate with LLMs and agents to build better software, faster.

Full explainer: journal/terrastep_101.md.

The format

A YAML frontmatter block (status, status_changed, type, next, ...) on every document inside directories you name in terrastep.toml (scan_dirs) — nowhere else in the repo is touched. type: plan documents also get a body-shape check: front sections (summary/ motivation/...), then exactly ## Blockers, ## Questions, ## Recommendations, ## Sequencing in order, with tagged, recommended items. type: legacy and type: note skip the body check. A generated index file (STATUS.md by default) lists every document by status; terrastep check fails if it's stale.

Using it

venv/bin/pip install -e .
terrastep next-id                 # next free plan document number
# write the doc under scan_dirs, then:
terrastep check                   # 0 if clean, 1 on any rule failure
terrastep build                   # regenerate the index
terrastep install-hooks           # pre-commit hook: blocks a bad staged commit
terrastep migrate propose/apply   # bring undocumented markdown under the format

Metadata

Release files for terrastep 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for terrastep 0.2.0
File Size Uploaded Provenance Actions
terrastep-0.2.0.tar.gz 73.3 kB Without provenance Details for terrastep-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for terrastep 0.2.0
File Interpreter ABI Platform Actions
terrastep-0.2.0-py3-none-any.whl Python 3 none any Details for terrastep-0.2.0-py3-none-any.whl

Total release size: 130.8 kB

Release files / terrastep-0.2.0.tar.gz

Download URL terrastep-0.2.0.tar.gz
Size 73.3 kB
Tags Source
SHA-256 checksum
How to use checksums
29800105110ea4c2e2a0ef348e758f7cb6970dbccb3e1273a996c5cfdc812e85
BLAKE2b-256 checksum
How to use checksums
9b34a756335f2b22bb7d121c67c68f67c3c7afc323ffae7c44a1accbb41f771c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.12

Release files / terrastep-0.2.0-py3-none-any.whl

Download URL terrastep-0.2.0-py3-none-any.whl
Size 57.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2c64aa99a9e88875eadc1f70c68e590cf89ca415539a444a2e24505385b66e43
BLAKE2b-256 checksum
How to use checksums
ebd50857a836ff8823ea42377abdc2bf45a56a8497fb770c5db59e175a354041
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.12

Security for terrastep 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page