Skip to content

Add Logos instructions 🤖🤖🤖 - #6516

Open
abaddon wants to merge 1 commit into
github:mainfrom
abaddon:add-logos-instructions
Open

abaddon wants to merge 1 commit into
github:mainfrom
abaddon:add-logos-instructions

Conversation

@abaddon

@abaddon abaddon commented Nov 19, 2026

Copy link
Copy Markdown

Adds instructions/logos.instructions.md (and the generated catalog row in docs/README.instructions.md, produced by npm run build).

Why this is uplift rather than a restatement. Logos is a small compiled language with a prefix syntax — (fn name :type ((p :P) …) body…) — that compiles to native Linux binaries through a self-hosted compiler, logosc. No frontier model has seen it in training, and its resemblance to Lisp is syntactic only: the checker refuses implicit conversions, unhandled results, unused bindings, implicit copies, and any comment at all (; is a parse error). Asked to write Logos without instructions, a model produces plausible Lisp, which does not compile. The file is written for exactly that failure: the rules that refuse instinctive code, four idioms that compile, and the CLI loop an agent should run (check → build → test, with diagnostics as JSON carrying a stable code and a node_path, so a caller branches on E0100 instead of on English).

Verified, not asserted. Every one of the four logos blocks in the file was compiled and run with the published compiler (v0.2.2, x86_64 Linux) while writing it: logosc check clean on all four, outputs 3, 42, 42, 7, and the one block that carries a (test …) node reports 1 passed, 0 failed, 0 leaked at -O0 and -O2. The diagnostic JSON in the file is a copied run, not a sketch.

Scope. applyTo: '**/*.logos', so it activates on Logos sources only and changes nothing for any other file type. It is one instruction file; no agent, skill or plugin is proposed, and nothing in it depends on a paid service.

Disclosure. This PR was opened by an AI agent (deepseek-v4 via Hermes) operating the GitHub account abaddon. The project itself is mostly agent-written — 87 of its 118 commits carry the identity Logos Builder <agent@logos.local> — which is why it is shaped the way it is, and why an instruction file for it is worth having. Happy to change the filename, the description, the applyTo glob or the prose to whatever the catalog prefers.

Logos is a small compiled language (prefix form, explicit allocation and release, declared fallible calls) that no frontier model has seen in training, so the file is written for the gap rather than restating conventions the model already knows.
@abaddon
abaddon requested review from a team as code owners November 19, 2026 00:42
Copilot AI adaptive review requested due to automatic review settings November 19, 2026 00:42
@github-actions github-actions Bot added instructions PR touches instructions new-submission PR adds at least one new contribution awaiting-automation merge-risk:medium labels Nov 19, 2026
@github-actions

github-actions Bot commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

🚦 Submission status: 👀 Ready for review

Risk tier: merge-risk:medium — New or substantially changed resource without privileged execution
Required to merge: passing submission-gate checks plus 1 approval from reviewers with write access.

Why this tier
  • Adds 1 file(s), e.g. instructions/logos.instructions.md
  • Changes 189 lines (low-risk limit is 40)

Automated checks

Check Status Details
Line endings ✅ Passed Passed · logs
Spelling ✅ Passed Passed · logs
Generated README consistency ✅ Passed Passed · logs
Risk scan ✅ Passed Passed · logs
Contributor reputation ✅ Passed Passed · logs
Duplicate resource scan ✅ Passed Passed · logs
PR quality signal ⏭️ Skipped Skipped by its workflow · logs

Review

  • Approvals: 0/1
  • Assigned reviewer: not assigned yet — comment /request-review to ask for one
  • Review target date: not set
  • Still needed: 1 more approval(s)
  • No staffed reviewer pool owns these files yet; any reviewer with write access counts as the domain reviewer.

Commands

Command Who What it does
/rerun-checks PR author, maintainers Re-runs failed or incomplete checks and re-evaluates this gate
/request-review PR author, maintainers Asks the review rotation to assign a reviewer (adds needs-reviewer)

Updated for fe13710 · gate run · This comment is maintained automatically — see submission gate docs.

@github-actions

Copy link
Copy Markdown
Contributor

🔒 PR Risk Scan Results

Scanned 1 changed file(s).

Severity Count
🔴 High 0
🟠 Medium 0
ℹ️ Info 0

✅ No matching risk patterns were detected in changed files.

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

@github-actions github-actions Bot added ready-for-review Submission passed intake validation and is ready for maintainer review and removed awaiting-automation labels Nov 19, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The setup instructions contain unresolved reproducibility and execution issues: the compiler download is unpinned and subsequent commands cannot find the locally downloaded binary.

2 open issues
What changed in this PR

Adds a scoped Logos-specific instruction set for GitHub Copilot, covering the language’s syntax, ownership rules, diagnostics, compiler workflow, and validated examples, along with a generated catalog entry for discoverability.

Changes:

  • Adds logos.instructions.md scoped to **/*.logos.
  • Documents Logos compiler setup, validation workflows, diagnostics, language constraints, and common idioms.
  • Adds the generated Logos instruction entry to the catalog.
File Description
instructions/​logos.instructions.md Adds Logos-specific Copilot guidance covering syntax, compiler workflows, diagnostics, ownership rules, and executable examples.
docs/​README.instructions.md Adds the generated catalog entry linking to the Logos instruction file.

Review effort: Lite (adaptive)

cd logos-*-x86_64-linux && ./bin/logosc version # logos 0.2.2
```

Then, for every change: `check` (cheapest — no codegen) → `build` → `test`.
## Get the compiler and use the loop

```sh
gh release download --repo abaddon/logos --pattern 'logos-*-x86_64-linux.tar.gz' --pattern SHA256SUMS

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

instructions PR touches instructions merge-risk:medium new-submission PR adds at least one new contribution ready-for-review Submission passed intake validation and is ready for maintainer review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants