Skip to content

Commit 16d48d8

Browse files
densmirnovdensmirnov
committed
Refresh organization profile README
1 parent f7aa571 commit 16d48d8

3 files changed

Lines changed: 300 additions & 75 deletions

File tree

‎profile/README.md‎

Lines changed: 93 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -1,75 +1,93 @@
1-
<div align="center">
2-
3-
# Basilisk Labs
4-
5-
**Infrastructure for long-range collaboration between people and autonomous agents.**
6-
7-
<p>
8-
<a href="https://basilisk-labs.com"><img alt="Website" src="https://img.shields.io/badge/website-basilisk--labs.com-111827?style=for-the-badge"></a>
9-
<a href="https://agentplane.org"><img alt="AgentPlane" src="https://img.shields.io/badge/project-AgentPlane-2563eb?style=for-the-badge"></a>
10-
<a href="mailto:hello@basilisk-labs.com"><img alt="Email" src="https://img.shields.io/badge/contact-hello%40basilisk--labs.com-0f766e?style=for-the-badge"></a>
11-
</p>
12-
13-
<p>
14-
<img alt="Git-native" src="https://img.shields.io/badge/Git--native-111827?style=flat">
15-
<img alt="Agent work" src="https://img.shields.io/badge/agent_work-evidence--first-2563eb?style=flat">
16-
<img alt="Audit trail" src="https://img.shields.io/badge/audit_trail-reviewable-0f766e?style=flat">
17-
<img alt="Open source" src="https://img.shields.io/badge/open_source-practical-7c3aed?style=flat">
18-
</p>
19-
20-
</div>
21-
22-
Basilisk Labs builds tools for agentic software work that needs memory, coordination, and
23-
accountability over time. Our current center of gravity is **AgentPlane**: an open-source audit
24-
layer that turns coding-agent sessions into reviewable Git artifacts.
25-
26-
We are interested in systems where the important question is not just whether an agent produced a
27-
diff, but whether a human or another agent can reconstruct the task, plan, approval, verification,
28-
and closure chain later.
29-
30-
## Focus
31-
32-
| Area | What we build |
33-
| --- | --- |
34-
| Agent coordination | Repo-local workflows for planning, handoff, verification, and finish states. |
35-
| Change evidence | Agent Change Records, task artifacts, signed catalogs, and reviewable traces. |
36-
| Developer tooling | CLI-first tools that work with Codex, Claude Code, Cursor, Aider, and GitHub Actions. |
37-
| Long-lived memory | Practices and infrastructure that preserve useful context without depending on chat history. |
38-
39-
## Projects
40-
41-
| Project | Status | Description |
42-
| --- | --- | --- |
43-
| [agentplane](https://github.com/basilisk-labs/agentplane) | Open source | Audit layer for coding agents. Keeps task, plan, verification, and closure evidence in Git. |
44-
| [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. |
45-
| [agentplane-recipes](https://github.com/basilisk-labs/agentplane-recipes) | Catalog | Signed recipes for reusable AgentPlane workflows and development practices. |
46-
| [setup-agentplane](https://github.com/basilisk-labs/setup-agentplane) | CI | GitHub Action for installing AgentPlane inside CI runners. |
47-
| [homebrew-tap](https://github.com/basilisk-labs/homebrew-tap) | Distribution | Homebrew tap for AgentPlane CLI releases. |
48-
| [scoop-bucket](https://github.com/basilisk-labs/scoop-bucket) | Distribution | Scoop manifests for AgentPlane on Windows. |
49-
| [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. |
50-
| [agentplane-marketing](https://github.com/basilisk-labs/agentplane-marketing) | Knowledge base | Public positioning, editorial, launch, and market-practice source documents for AgentPlane. |
51-
52-
## Principles
53-
54-
- Keep workflow evidence close to the code.
55-
- Prefer explicit plans and verification over invisible agent state.
56-
- Make artifacts useful to both humans and machines.
57-
- Treat benchmarks, recipes, and integrations as evidence surfaces, not just growth assets.
58-
- Build small, inspectable tools before adding hosted complexity.
59-
60-
## Start here
61-
62-
```bash
63-
npm i -g agentplane
64-
agentplane init
65-
agentplane quickstart
66-
```
67-
68-
Read the docs at [agentplane.org](https://agentplane.org) or start from the
69-
[AgentPlane repository](https://github.com/basilisk-labs/agentplane).
70-
71-
## Contact
72-
73-
- Email: [hello@basilisk-labs.com](mailto:hello@basilisk-labs.com)
74-
- Website: [basilisk-labs.com](https://basilisk-labs.com)
75-
- AgentPlane: [agentplane.org](https://agentplane.org)
1+
<p align="center">
2+
<img src="https://raw.githubusercontent.com/basilisk-labs/.github/main/profile/assets/basilisk-labs-header.svg" alt="Basilisk Labs GitHub profile header" style="width:100%;max-width:100%;">
3+
</p>
4+
5+
<div align="center">
6+
7+
# Basilisk Labs
8+
9+
**Local-first infrastructure for inspectable autonomous-agent work.**
10+
11+
<p>
12+
<a href="https://basilisk-labs.com"><img alt="Website" src="https://img.shields.io/badge/website-basilisk--labs.com-111827?style=for-the-badge"></a>
13+
<a href="https://agentplane.org"><img alt="AgentPlane" src="https://img.shields.io/badge/project-AgentPlane-ff4d00?style=for-the-badge"></a>
14+
<a href="https://github.com/basilisk-labs/agentplane/releases/tag/v0.6.2"><img alt="AgentPlane v0.6.2" src="https://img.shields.io/badge/AgentPlane-v0.6.2-18794e?style=for-the-badge"></a>
15+
<a href="mailto:hello@basilisk-labs.com"><img alt="Email" src="https://img.shields.io/badge/contact-hello%40basilisk--labs.com-0f766e?style=for-the-badge"></a>
16+
</p>
17+
18+
<p>
19+
<img alt="Git-native" src="https://img.shields.io/badge/Git--native-evidence-111827?style=flat">
20+
<img alt="Local-first" src="https://img.shields.io/badge/local--first-no_hosted_runtime-2563eb?style=flat">
21+
<img alt="Agent Change Record" src="https://img.shields.io/badge/ACR-reviewable_manifest-7ea2ff?style=flat">
22+
<img alt="Recipes" src="https://img.shields.io/badge/recipes-signed_catalog-6e56cf?style=flat">
23+
</p>
24+
25+
</div>
26+
27+
Basilisk Labs builds open-source systems for agentic software work that must remain reconstructable
28+
after the terminal session is gone. The center of gravity is **AgentPlane**: a Git-native workflow
29+
control layer that records task intent, accepted plans, verification evidence, finish state, and
30+
Agent Change Records beside the code.
31+
32+
The operating premise is simple: a pull request should show more than a diff. It should preserve
33+
why the change exists, which policy bounded it, which checks ran, and what another human or agent
34+
can audit later.
35+
36+
## Current work
37+
38+
| Surface | Repository | What it is |
39+
| --- | --- | --- |
40+
| Workflow control | [agentplane](https://github.com/basilisk-labs/agentplane) | CLI for task -> plan -> approve -> implement -> verify -> finish, with repo-local evidence and ACR. |
41+
| 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. |
42+
| Reusable behavior | [agentplane-recipes](https://github.com/basilisk-labs/agentplane-recipes) | Signed recipe catalog for reusable coding-agent workflows, repo mapping, and development playbooks. |
43+
| Blueprint catalog | [agentplane-blueprints](https://github.com/basilisk-labs/agentplane-blueprints) | Installable AgentPlane blueprints for verification routes and task execution patterns. |
44+
| CI install path | [setup-agentplane](https://github.com/basilisk-labs/setup-agentplane) | GitHub Action for installing AgentPlane in CI runners from release assets. |
45+
| 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. |
46+
| 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. |
47+
| Research workspace | [openclaw-deus](https://github.com/basilisk-labs/openclaw-deus) | Experimental automation workspace for local agent workflow research and prototypes. |
48+
49+
## AgentPlane in one screen
50+
51+
```text
52+
task -> plan -> approve -> implement -> verify -> finish
53+
|
54+
v
55+
Agent Change Record
56+
```
57+
58+
AgentPlane is not another coding agent. Claude Code, Codex, Cursor, Aider, and similar tools do the
59+
editing. AgentPlane wraps that work in local lifecycle state, policy routing, verification notes,
60+
and reviewable artifacts.
61+
62+
```bash
63+
npm i -g agentplane
64+
agentplane init
65+
agentplane quickstart
66+
```
67+
68+
Core surfaces:
69+
70+
- **ACR:** commit-safe JSON evidence for task intent, approved plan, commits, verification, and merge readiness.
71+
- **Local context:** repository-owned memory through `context/raw`, `context/wiki`, sourced facts, graph data, and derived projections.
72+
- **Workflow modes:** `direct` for local loops, `branch_pr` for task branches, worktrees, PR review artifacts, and integration flow.
73+
- **Recipes and blueprints:** signed reusable behavior modules for repo mapping, agent profiles, prompts, and verification paths.
74+
- **Distribution:** npm, Homebrew, Scoop, standalone release assets, and GitHub Actions setup.
75+
76+
## Principles
77+
78+
- Keep workflow evidence close to the code.
79+
- Prefer explicit plans and verification over invisible agent state.
80+
- Preserve local ownership: no hosted runtime is required for the core workflow.
81+
- Make artifacts useful to both humans and machines.
82+
- Treat benchmarks, recipes, and integrations as evidence surfaces, not just growth assets.
83+
84+
## Links
85+
86+
| Destination | Link |
87+
| --- | --- |
88+
| Website | [basilisk-labs.com](https://basilisk-labs.com) |
89+
| AgentPlane docs | [agentplane.org](https://agentplane.org) |
90+
| AgentPlane repository | [github.com/basilisk-labs/agentplane](https://github.com/basilisk-labs/agentplane) |
91+
| Contact | [hello@basilisk-labs.com](mailto:hello@basilisk-labs.com) |
92+
93+
<sub>The header is generated by `node scripts/generate-profile-header.mjs` and checked with `node scripts/generate-profile-header.mjs --check`.</sub>

‎profile/assets/basilisk-labs-header.svg‎

Lines changed: 90 additions & 0 deletions
Loading

‎scripts/generate-profile-header.mjs‎

Lines changed: 117 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,117 @@
1+
import { mkdir, readFile, writeFile } from "node:fs/promises";
2+
import path from "node:path";
3+
import { fileURLToPath } from "node:url";
4+
5+
const __filename = fileURLToPath(import.meta.url);
6+
const __dirname = path.dirname(__filename);
7+
const repoRoot = path.resolve(__dirname, "..");
8+
const outputPath = path.join(repoRoot, "profile/assets/basilisk-labs-header.svg");
9+
const checkMode = process.argv.includes("--check");
10+
11+
function renderGrid() {
12+
const vertical = Array.from({ length: 15 }, (_, index) => {
13+
const x = 40 + index * 80;
14+
return `<line x1="${x}" y1="42" x2="${x}" y2="586" />`;
15+
}).join("\n");
16+
17+
const horizontal = Array.from({ length: 8 }, (_, index) => {
18+
const y = 42 + index * 72;
19+
return `<line x1="40" y1="${y}" x2="1160" y2="${y}" />`;
20+
}).join("\n");
21+
22+
return `${vertical}\n${horizontal}`;
23+
}
24+
25+
function renderSvg() {
26+
return `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630" role="img" aria-labelledby="title desc">
27+
<title id="title">Basilisk Labs GitHub profile header</title>
28+
<desc id="desc">A Basilisk Labs header in the style of basilisk-labs.com, with an inspectable agent infrastructure message.</desc>
29+
<defs>
30+
<linearGradient id="paper" x1="0" y1="0" x2="1" y2="1">
31+
<stop offset="0" stop-color="#fffefd"/>
32+
<stop offset="0.52" stop-color="#fafaf7"/>
33+
<stop offset="1" stop-color="#eceef4"/>
34+
</linearGradient>
35+
<linearGradient id="glass" x1="0" y1="0" x2="1" y2="1">
36+
<stop offset="0" stop-color="#ffffff" stop-opacity="0.82"/>
37+
<stop offset="1" stop-color="#f8f8f5" stop-opacity="0.56"/>
38+
</linearGradient>
39+
<filter id="softShadow" x="-20%" y="-20%" width="140%" height="140%">
40+
<feDropShadow dx="0" dy="24" stdDeviation="26" flood-color="#111113" flood-opacity="0.12"/>
41+
</filter>
42+
</defs>
43+
<rect width="1200" height="630" fill="url(#paper)"/>
44+
<g stroke="#e6e4dd" stroke-width="1" opacity="0.92">
45+
${renderGrid()}
46+
</g>
47+
<g stroke="#c7c4bc" stroke-width="1.1" opacity="0.72">
48+
<path d="M120 90 L320 250 L520 90 L720 250 L920 90 L1080 220"/>
49+
<path d="M120 500 L320 330 L520 500 L720 330 L920 500 L1080 390"/>
50+
<path d="M320 250 L320 330"/>
51+
<path d="M520 90 L520 500"/>
52+
<path d="M720 250 L720 330"/>
53+
<path d="M920 90 L920 500"/>
54+
</g>
55+
<g fill="#ff4d00">
56+
<circle cx="520" cy="90" r="5"/>
57+
<circle cx="720" cy="330" r="5"/>
58+
<circle cx="1080" cy="390" r="5"/>
59+
</g>
60+
<g fill="#7ea2ff">
61+
<circle cx="320" cy="250" r="4"/>
62+
<circle cx="920" cy="500" r="4"/>
63+
</g>
64+
<g filter="url(#softShadow)">
65+
<rect x="74" y="86" width="686" height="430" rx="22" fill="url(#glass)" stroke="#ffffff" stroke-width="1.2"/>
66+
<rect x="74.5" y="86.5" width="685" height="429" rx="21.5" fill="none" stroke="#e6e4dd" stroke-opacity="0.55"/>
67+
</g>
68+
<g font-family="Inter, system-ui, -apple-system, BlinkMacSystemFont, Segoe UI, sans-serif">
69+
<text x="112" y="138" fill="#666a73" font-size="15" font-weight="650" letter-spacing="3">BASILISK LABS / GITHUB</text>
70+
<text x="112" y="238" fill="#111113" font-size="72" font-weight="560" letter-spacing="-2.4">Inspectable work.</text>
71+
<text x="112" y="318" fill="#111113" font-size="72" font-weight="560" letter-spacing="-2.4">Inspectable agents.</text>
72+
<text x="112" y="384" fill="#666a73" font-size="25" font-weight="430">Open-source infrastructure for agent work, memory,</text>
73+
<text x="112" y="420" fill="#666a73" font-size="25" font-weight="430">reviewable evidence, and local-first coordination.</text>
74+
<g font-family="JetBrains Mono, Menlo, monospace" font-size="17" font-weight="600">
75+
<rect x="112" y="456" width="158" height="38" rx="19" fill="#111113"/>
76+
<text x="133" y="481" fill="#ffffff">AGENTPLANE</text>
77+
<rect x="286" y="456" width="112" height="38" rx="19" fill="#f8f8f5" stroke="#d8d5cc"/>
78+
<text x="308" y="481" fill="#111113">ACR</text>
79+
<rect x="414" y="456" width="150" height="38" rx="19" fill="#f8f8f5" stroke="#d8d5cc"/>
80+
<text x="436" y="481" fill="#111113">RECIPES</text>
81+
<rect x="580" y="456" width="118" height="38" rx="19" fill="#fff4ed" stroke="#ffb18a"/>
82+
<text x="602" y="481" fill="#c23b22">X-RAY</text>
83+
</g>
84+
</g>
85+
<g font-family="JetBrains Mono, Menlo, monospace" fill="#111113">
86+
<text x="850" y="148" font-size="14" letter-spacing="2">TRACE_CHAIN</text>
87+
<text x="850" y="184" font-size="20">task -> plan -> verify</text>
88+
<text x="850" y="224" font-size="14" letter-spacing="2" fill="#666a73">LOCAL_FIRST</text>
89+
<text x="850" y="260" font-size="20">repo evidence, not chat drift</text>
90+
<text x="850" y="300" font-size="14" letter-spacing="2" fill="#666a73">STATUS</text>
91+
<text x="850" y="336" font-size="20" fill="#18794e">inspectable</text>
92+
</g>
93+
</svg>
94+
`;
95+
}
96+
97+
async function main() {
98+
const svg = renderSvg();
99+
100+
if (checkMode) {
101+
const current = await readFile(outputPath, "utf8");
102+
if (current !== svg) {
103+
console.error("Profile header artifact is stale.");
104+
console.error("Run: node scripts/generate-profile-header.mjs");
105+
process.exitCode = 1;
106+
return;
107+
}
108+
console.log("Profile header artifact is fresh.");
109+
return;
110+
}
111+
112+
await mkdir(path.dirname(outputPath), { recursive: true });
113+
await writeFile(outputPath, svg, "utf8");
114+
console.log(`generated ${path.relative(repoRoot, outputPath)}`);
115+
}
116+
117+
await main();

0 commit comments

Comments
 (0)