The Venoly Engineering Constitution

Understandbeforechanging.

Verifybeforeclaiming.

Testbeforetrusting.

Documentbeforeforgetting.

§ 2, Core principle

Eighty-four articles that decide what has to be true before a change ships. The same rules bind the people who work here and the autonomous agents that work alongside them. It is public, it is versioned, and you are welcome to run it on your own repositories.

Version 1.0Production specification84 articlesMIT

A document you can be held to.

What it is

The Constitution is the answer to a specific problem: an engineer — or an agent — who is fast, plausible and wrong. Every article closes one route to that outcome.

§ 11

A specification, not a manifesto.

Every article is a rule someone can be held to. A finished task has to report what was added, changed, removed, preserved and fixed — plus what could still go wrong, what was actually tested, and what was deliberately left undone.

§ 52

It binds agents and people the same way.

The doctrine was written for autonomous engineering agents, and it is the standard the people here work to. Fabricating command output, test results, file contents, API responses, deployment status, security findings, repository state or tool capabilities is forbidden. If you did not run it, say so.

ultra-agent

It is loaded, not filed.

The Constitution ships as a loadable skill inside ultra-agent, so an agent reads it at the start of substantial work rather than being told about it once and drifting from it by the third file.

v1.0

It is versioned.

Version 1.0, marked Production Specification. Articles get amended deliberately and the version moves with them. Nothing in here is tidied up in passing.

Four clauses, quoted.

Selected articles

Straight from the specification. The full text of all eighty-four is on GitHub.

§18
Security engineering

On how to describe your own security work:

Never claim something is “100% secure”.
Use instead
  • “No issues were identified within the reviewed scope.”
  • “This reduces the attack surface.”
  • “This was not independently penetration tested.”
§53
Anti-hallucination rule

When something cannot be established, it gets labelled rather than smoothed over:

KNOWNWhat has been verified.
INFERREDWhat appears likely.
UNKNOWNWhat cannot currently be established.
REQUIREDWhat information would resolve the uncertainty.
Never convert an inference into a fact.
§62
“Done” definition

Nine conditions have to hold before a task counts as finished:

  • the requested behavior exists
  • it is integrated into the surrounding system
  • relevant failure states are handled
  • relevant security controls exist
  • appropriate tests exist
  • available verification has been performed
  • documentation is accurate
  • no known critical regression remains
  • remaining limitations are explicitly disclosed
“Code written” does not equal “done.”
§65
Never hide scope expansion

Work that reaches past the request has to say so, in the report, at the time:

If solving the requested task requires touching additional systems, explain why. … Do not silently expand scope.

When two requirements disagree, this settles it.

§ 83, Engineering priority order

Not a values statement — a tie-breaker, applied in order. Convenience never outranks data integrity, and no amount of preference moves cosmetics above correctness.

  1. 1Safety
  2. 2Security
  3. 3Data integrity
  4. 4Correctness
  5. 5Explicit user requirements
  6. 6Compatibility
  7. 7Reliability
  8. 8Maintainability
  9. 9Performance
  10. 10Convenience
  11. 11Cosmetic preference

The article ends where it matters: if an explicit user requirement conflicts with a higher-priority concern, explain the conflict instead of silently violating it.

All eighty-four.

The articles

Grouped into nine parts. Numbers and titles are the specification’s own; the parts are how we read it.

IFoundations8
  • 1Identity
  • 2Core principle
  • 3Primary objectives
  • 4Agent mindset
  • 5Autonomy
  • 6Questions are required when necessary
  • 7Question priority
  • 8Never guess critical requirements
IIBefore the change7
  • 9Repository discovery
  • 10Change classification
  • 11Change transparency
  • 12Pros and cons are mandatory for significant changes
  • 13[ADD] and [REMOVE] decisions
  • 14Feature completeness
  • 15Routing audit
IIIBuilding it15
  • 16API engineering
  • 17Database engineering
  • 18Security engineering
  • 19Secret management
  • 20Error handling
  • 21Testing standard
  • 22Verification
  • 23Test failure protocol
  • 24Dependencies
  • 25Architecture
  • 26Performance
  • 27Frontend quality
  • 28Backend quality
  • 29DevOps
  • 30Deployment decision
IVWorking together5
  • 31Agent collaboration
  • 32Specialist delegation
  • 33Conflict resolution between agents
  • 34Change safety
  • 35Backwards compatibility
VLeaving a record12
  • 36Documentation
  • 37Changelog requirement
  • 38Git discipline
  • 39File discipline
  • 40Removal policy
  • 41Dead code
  • 42Technical debt
  • 43Automatic improvement
  • 44Continuous audit
  • 45Full project audit mode
  • 46Finding severity
  • 47Finding format
VIWhen it goes wrong8
  • 48Incident mode
  • 49Recovery
  • 50User approval boundaries
  • 51Privacy
  • 52AI-specific behavior
  • 53Anti-hallucination rule
  • 54No false completion
  • 55Final review
VIIReporting5
  • 56Final response format
  • 57Optional changes
  • 58When to ask questions vs act
  • 59Default decision principles
  • 60Never optimize for appearance
VIIIThe Venoly standard10
  • 61Unique Venoly standard
  • 62“Done” definition
  • 63Never hide deletions
  • 64Never hide additions
  • 65Never hide scope expansion
  • 66Code quality standard
  • 67Comments
  • 68Security over convenience
  • 69Data integrity over speed
  • 70Production principle
IXRunning in production14
  • 71Retries
  • 72External services
  • 73Feature flags
  • 74Migrations
  • 75Observability
  • 76Audit trail
  • 77Rate limiting
  • 78Authorization
  • 79Resource ownership
  • 80Failure transparency
  • 81Self-review
  • 82User intent
  • 83Engineering priority order
  • 84Final principle

VEC is also the name of the crew.

The people

The copyright line on our repositories reads The Venoly Engineering Constitution, because the document and the group who write it are the same thing.

The same group builds the open tooling above, reviews the Venoly platform against § 18, and competes in capture-the-flag. Security work and engineering work are not separate departments here — the article that governs a security review is in the same document as the one that governs a database migration.

What we have to show is in the repositories.

Join the crew

Engineering or security. Tell us what you have built and what you want to break.

founder@venoly.nl
Found something in our platform

Responsible disclosure has its own page, with scope and safe-harbour terms.

Bug bounty

Attestation

Version
1.0
Status
Production specification
Articles
84
Licence
MIT
Authored by
@mcs.s — Discord
@founder — venoly.nl
Owned & published by
Venoly B.V. — Netherlands

Public code lives in the organisation. The Venoly platform itself is not open source and does not live there — that split is deliberate and is not up for tidying.

Venoly
Venoly
Loading