liquidware-ninjaSecond brain & toolkit
Personal project. Research and learning only. Not for production. No warranty.Not for production
  • Built on my own time for research and learning. Not affiliated with, endorsed by or supported by my employer, Liquidware or Microsoft.
  • Bring your own Liquidware licenses. Don't run any of it in production or against tenants and subscriptions that matter. Test in a dedicated lab first.
  • Provided "as is", without warranty of any kind, under each repository's license. You use it at your own risk and own the Azure charges it incurs.
  • Contributions and forks are welcome and encouraged on public repos. See Contribute.

0001. Adopt the 2ndbrain knowledge base format, version 1

acceptedReviewed 2026-10-18Source: decisions/0001-adopt-the-2ndbrain-format.md

Context and Problem Statement

This project learns things about Stratusphere in Azure that nobody has written down: Marketplace plans, appliance credentials, callback paths, what the API can and can't do. Those findings were spread across tool docs, a research note and memory. Where should they live, and in what format?

Considered Options

  • Adopt the family's 2ndbrain format (version 1), exported from the 2ndbrain template
  • A format of its own, such as the lessons folder the tooling started with
  • No in-repo knowledge base; keep notes elsewhere

Decision Outcome

Chosen option: "Adopt the 2ndbrain format", because its checks, digest and freshness loops are already built and tested, it uses no LLM tokens or API keys to run, and the sibling knowledge bases in family.yaml can watch and link to this one.

Consequences

  • Good, because knowledge changes in the same PR as the code it describes.
  • Good, because format changes arrive through the template and are adopted by PR.
  • Neutral, because topics and data are this project's own; only the format is shared.
  • Neutral, because the tool docs under stratusphere/docs/ stay as how-to guides, and the KB links to them rather than repeating them.

More Information

The system is specified in the 2ndbrain spec. The family's own record: nerdio-hcl 0021.

Linked from one page