diff --git a/profile/README.md b/profile/README.md index df48eb9..c2cb4dc 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,75 +1,93 @@ -
- -# Basilisk Labs - -**Infrastructure for long-range collaboration between people and autonomous agents.** - -

- Website - AgentPlane - Email -

- -

- Git-native - Agent work - Audit trail - Open source -

- -
- -Basilisk Labs builds tools for agentic software work that needs memory, coordination, and -accountability over time. Our current center of gravity is **AgentPlane**: an open-source audit -layer that turns coding-agent sessions into reviewable Git artifacts. - -We are interested in systems where the important question is not just whether an agent produced a -diff, but whether a human or another agent can reconstruct the task, plan, approval, verification, -and closure chain later. - -## Focus - -| Area | What we build | -| --- | --- | -| Agent coordination | Repo-local workflows for planning, handoff, verification, and finish states. | -| Change evidence | Agent Change Records, task artifacts, signed catalogs, and reviewable traces. | -| Developer tooling | CLI-first tools that work with Codex, Claude Code, Cursor, Aider, and GitHub Actions. | -| Long-lived memory | Practices and infrastructure that preserve useful context without depending on chat history. | - -## Projects - -| Project | Status | Description | -| --- | --- | --- | -| [agentplane](https://github.com/basilisk-labs/agentplane) | Open source | Audit layer for coding agents. Keeps task, plan, verification, and closure evidence in Git. | -| [agent-change-record](https://github.com/basilisk-labs/agent-change-record) | Open standard | JSON schema and tooling for machine-readable evidence manifests for agent-authored changes. | -| [agentplane-recipes](https://github.com/basilisk-labs/agentplane-recipes) | Catalog | Signed recipes for reusable AgentPlane workflows and development practices. | -| [setup-agentplane](https://github.com/basilisk-labs/setup-agentplane) | CI | GitHub Action for installing AgentPlane inside CI runners. | -| [homebrew-tap](https://github.com/basilisk-labs/homebrew-tap) | Distribution | Homebrew tap for AgentPlane CLI releases. | -| [scoop-bucket](https://github.com/basilisk-labs/scoop-bucket) | Distribution | Scoop manifests for AgentPlane on Windows. | -| [agentplane-harbor-adapter](https://github.com/basilisk-labs/agentplane-harbor-adapter) | Experimental | Benchmark adapter for evaluating AgentPlane as a control-plane wrapper around coding agents. | -| [agentplane-marketing](https://github.com/basilisk-labs/agentplane-marketing) | Knowledge base | Public positioning, editorial, launch, and market-practice source documents for AgentPlane. | - -## Principles - -- Keep workflow evidence close to the code. -- Prefer explicit plans and verification over invisible agent state. -- Make artifacts useful to both humans and machines. -- Treat benchmarks, recipes, and integrations as evidence surfaces, not just growth assets. -- Build small, inspectable tools before adding hosted complexity. - -## Start here - -```bash -npm i -g agentplane -agentplane init -agentplane quickstart -``` - -Read the docs at [agentplane.org](https://agentplane.org) or start from the -[AgentPlane repository](https://github.com/basilisk-labs/agentplane). - -## Contact - -- Email: [hello@basilisk-labs.com](mailto:hello@basilisk-labs.com) -- Website: [basilisk-labs.com](https://basilisk-labs.com) -- AgentPlane: [agentplane.org](https://agentplane.org) +

+ Basilisk Labs GitHub profile header +

+ +
+ +# Basilisk Labs + +**Local-first infrastructure for inspectable autonomous-agent work.** + +

+ Website + AgentPlane + AgentPlane v0.6.2 + Email +

+ +

+ Git-native + Local-first + Agent Change Record + Recipes +

+ +
+ +Basilisk Labs builds open-source systems for agentic software work that must remain reconstructable +after the terminal session is gone. The center of gravity is **AgentPlane**: a Git-native workflow +control layer that records task intent, accepted plans, verification evidence, finish state, and +Agent Change Records beside the code. + +The operating premise is simple: a pull request should show more than a diff. It should preserve +why the change exists, which policy bounded it, which checks ran, and what another human or agent +can audit later. + +## Current work + +| Surface | Repository | What it is | +| --- | --- | --- | +| Workflow control | [agentplane](https://github.com/basilisk-labs/agentplane) | CLI for task -> plan -> approve -> implement -> verify -> finish, with repo-local evidence and ACR. | +| Evidence standard | [agent-change-record](https://github.com/basilisk-labs/agent-change-record) | JSON schema and tooling for machine-readable manifests of agent-authored changes. | +| Reusable behavior | [agentplane-recipes](https://github.com/basilisk-labs/agentplane-recipes) | Signed recipe catalog for reusable coding-agent workflows, repo mapping, and development playbooks. | +| Blueprint catalog | [agentplane-blueprints](https://github.com/basilisk-labs/agentplane-blueprints) | Installable AgentPlane blueprints for verification routes and task execution patterns. | +| CI install path | [setup-agentplane](https://github.com/basilisk-labs/setup-agentplane) | GitHub Action for installing AgentPlane in CI runners from release assets. | +| Release channels | [homebrew-tap](https://github.com/basilisk-labs/homebrew-tap), [scoop-bucket](https://github.com/basilisk-labs/scoop-bucket) | Homebrew and Scoop distribution for the AgentPlane CLI. | +| Evaluation adapters | [agentplane-harbor-adapter](https://github.com/basilisk-labs/agentplane-harbor-adapter), [agentplane-bitgn-adapter](https://github.com/basilisk-labs/agentplane-bitgn-adapter) | Benchmark adapters for running AgentPlane as a reproducible coding-agent harness. | +| Research workspace | [openclaw-deus](https://github.com/basilisk-labs/openclaw-deus) | Experimental automation workspace for local agent workflow research and prototypes. | + +## AgentPlane in one screen + +```text +task -> plan -> approve -> implement -> verify -> finish + | + v + Agent Change Record +``` + +AgentPlane is not another coding agent. Claude Code, Codex, Cursor, Aider, and similar tools do the +editing. AgentPlane wraps that work in local lifecycle state, policy routing, verification notes, +and reviewable artifacts. + +```bash +npm i -g agentplane +agentplane init +agentplane quickstart +``` + +Core surfaces: + +- **ACR:** commit-safe JSON evidence for task intent, approved plan, commits, verification, and merge readiness. +- **Local context:** repository-owned memory through `context/raw`, `context/wiki`, sourced facts, graph data, and derived projections. +- **Workflow modes:** `direct` for local loops, `branch_pr` for task branches, worktrees, PR review artifacts, and integration flow. +- **Recipes and blueprints:** signed reusable behavior modules for repo mapping, agent profiles, prompts, and verification paths. +- **Distribution:** npm, Homebrew, Scoop, standalone release assets, and GitHub Actions setup. + +## Principles + +- Keep workflow evidence close to the code. +- Prefer explicit plans and verification over invisible agent state. +- Preserve local ownership: no hosted runtime is required for the core workflow. +- Make artifacts useful to both humans and machines. +- Treat benchmarks, recipes, and integrations as evidence surfaces, not just growth assets. + +## Links + +| Destination | Link | +| --- | --- | +| Website | [basilisk-labs.com](https://basilisk-labs.com) | +| AgentPlane docs | [agentplane.org](https://agentplane.org) | +| AgentPlane repository | [github.com/basilisk-labs/agentplane](https://github.com/basilisk-labs/agentplane) | +| Contact | [hello@basilisk-labs.com](mailto:hello@basilisk-labs.com) | + +The header is generated by `node scripts/generate-profile-header.mjs` and checked with `node scripts/generate-profile-header.mjs --check`. diff --git a/profile/assets/basilisk-labs-header.svg b/profile/assets/basilisk-labs-header.svg new file mode 100644 index 0000000..f45c273 --- /dev/null +++ b/profile/assets/basilisk-labs-header.svg @@ -0,0 +1,90 @@ + +Basilisk Labs GitHub profile header +A Basilisk Labs header in the style of basilisk-labs.com, with an inspectable agent infrastructure message. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + BASILISK LABS / GITHUB + Inspectable work. + Inspectable agents. + Open-source infrastructure for agent work, memory, + reviewable evidence, and local-first coordination. + + + AGENTPLANE + + ACR + + RECIPES + + X-RAY + + + + TRACE_CHAIN + task -> plan -> verify + LOCAL_FIRST + repo evidence, not chat drift + STATUS + inspectable + + diff --git a/scripts/generate-profile-header.mjs b/scripts/generate-profile-header.mjs new file mode 100644 index 0000000..bc7203f --- /dev/null +++ b/scripts/generate-profile-header.mjs @@ -0,0 +1,117 @@ +import { mkdir, readFile, writeFile } from "node:fs/promises"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const __filename = fileURLToPath(import.meta.url); +const __dirname = path.dirname(__filename); +const repoRoot = path.resolve(__dirname, ".."); +const outputPath = path.join(repoRoot, "profile/assets/basilisk-labs-header.svg"); +const checkMode = process.argv.includes("--check"); + +function renderGrid() { + const vertical = Array.from({ length: 15 }, (_, index) => { + const x = 40 + index * 80; + return ``; + }).join("\n"); + + const horizontal = Array.from({ length: 8 }, (_, index) => { + const y = 42 + index * 72; + return ``; + }).join("\n"); + + return `${vertical}\n${horizontal}`; +} + +function renderSvg() { + return ` +Basilisk Labs GitHub profile header +A Basilisk Labs header in the style of basilisk-labs.com, with an inspectable agent infrastructure message. + + + + + + + + + + + + + + + + +${renderGrid()} + + + + + + + + + + + + + + + + + + + + + + + + BASILISK LABS / GITHUB + Inspectable work. + Inspectable agents. + Open-source infrastructure for agent work, memory, + reviewable evidence, and local-first coordination. + + + AGENTPLANE + + ACR + + RECIPES + + X-RAY + + + + TRACE_CHAIN + task -> plan -> verify + LOCAL_FIRST + repo evidence, not chat drift + STATUS + inspectable + + +`; +} + +async function main() { + const svg = renderSvg(); + + if (checkMode) { + const current = await readFile(outputPath, "utf8"); + if (current !== svg) { + console.error("Profile header artifact is stale."); + console.error("Run: node scripts/generate-profile-header.mjs"); + process.exitCode = 1; + return; + } + console.log("Profile header artifact is fresh."); + return; + } + + await mkdir(path.dirname(outputPath), { recursive: true }); + await writeFile(outputPath, svg, "utf8"); + console.log(`generated ${path.relative(repoRoot, outputPath)}`); +} + +await main();