agentleFS
solanabrsolanabr/startup-builder-skill/skills/build-status/SKILL.md

build-status

Skill2 starsChanged 20 days agoMITView on GitHub

Capture what is built, deployed and used into .claude/context/build.md — program IDs, verified build, audit state, what works today, and traction with the query behind each number. Use before a deck, hackathon submission, grant or investor update, or when asked "what have we shipped".

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Every claim gets a source.

    line 10
  2. Distinctive:

    Ask only for what the repo cannot tell you.

    line 27

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Build Status

Inspect the repo and the chain → record what is true today → write .claude/context/build.md. Every claim gets a source. This file feeds pitch-deck, hackathon and idea-sprint, so a wrong number here ends up on a slide.

Format and merge rules (the contract every producer follows): build-md-format.md.

Context handoff

  • At start: read .claude/context/build.md if present and merge into it; read .claude/context/idea.md if present for the product name and the core flow.
  • On completion: write .claude/context/build.md. Never delete a section another skill or tool wrote.

Workflow

1. Gather from the repo, not the founder

Ask only for what the repo cannot tell you. Look first:

  • Program IDs: declare_id!, Anchor.toml [programs.*], and the files ai-kit's /deploy records (.program-id-devnet, .program-id-mainnet, deployment-mainnet.json with deployer, upgrade authority and commit).
  • Tests: run the suite once and record pass/fail with the date. Don't record "passing" from memory or from a CI badge you did not check.
  • Audit state: the latest report in the repo, or an /audit-solana findings file. Count open findings by severity.
  • Milestones: git log tags and merge commits, dated.

2. Confirm against the chain

For each program ID on mainnet (and devnet, labelled as such):

  • solana program show <ID> -u <cluster> → exists, upgrade authority, last deploy slot.
  • Verified build: https://verify.osec.io/status/<ID> returns is_verified, the repo and the commit. "Built with solana-verify" is not the same as verified; only the status counts.
  • Upgrade authority is a trust fact, not a detail: deployer key, a Squads vault, or none (immutable). Write which. For a vault, take the threshold from the Squads multisig account, not from solana program show, which prints only the address.

3. What works today

List only flows a stranger could run right now, each with its cluster and a proof — a transaction signature, an explorer link or a live URL. Re-check the list on every run and drop anything that no longer works; roadmap never goes here. Optionally note known-broken flows underneath so nobody demos them by accident.

4. Traction, with sources

Mainnet only. For each number: value, window, as-of date, and the query or system it came from. A number without a source is not written. Methods per metric, and the Solana-specific ways these numbers get inflated: traction-sources.md.

Pre-launch is fine — write the waitlist or pilot counts with their source, or write "none yet". Don't let a deck invent what this file says is zero.

5. Write and show the diff

Merge per the format rules, set Updated, and show the user what changed against the previous version. Flag any number that moved more than 2x since the last run and ask why before keeping it.

Hand-offs

  • Deploy, verification, audits: ai-kit's /deploy, the verify-PDA upload and solana-verify remote submit-job in its deployment skill (/deploy only verifies locally; the verify.osec.io status flips after the submit-job), /build-program and /audit-solana. This skill records their results; it doesn't redo them.
  • Next: pitch-deck or hackathon, which pre-fill traction and "what works" from this file.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.