Publish DevRunbook source
Managed validation / full (push) Successful in 3m18s

This commit is contained in:
DevRunbook release export
2026-09-03 04:09:17 +02:00
commit cfd2804e27
928 changed files with 161642 additions and 0 deletions
+17
View File
@@ -0,0 +1,17 @@
# Global Codex instructions
Use this file only for personal rules that should apply to every repository.
## Working preferences
- Inspect existing configuration and repository instructions before editing.
- Never claim a command or test passed unless it was run successfully.
- Preserve unrelated user changes.
- Avoid destructive Git operations unless explicitly requested.
- Keep secrets out of output and logs.
## Reporting
Summarize completed work, validation evidence, remaining limitations and recommended follow-up.
Do not place project-specific commands or temporary task requirements in this global file.
+39
View File
@@ -0,0 +1,39 @@
# Repository instructions
## Product purpose
[Describe the product and critical behavior in 25 sentences.]
## Repository structure
- `[path]`: [purpose]
- `[path]`: [purpose]
## Required commands
- Install: `[command]`
- Format check: `[command]`
- Lint: `[command]`
- Typecheck: `[command]`
- Tests: `[command]`
- Build: `[command]`
- Smoke test: `[command]`
Only include commands that are verified or clearly marked as needing confirmation.
## Engineering constraints
- [Backwards-compatibility policy]
- [Dependency policy]
- [Migration policy]
- [Documentation expectations]
## Protected paths and data
- Do not modify: `[path]`
- Do not read or expose secrets from: `[path/pattern]`
- Treat runtime/user data under `[path]` as protected.
## Completion standard
A task is complete only when relevant checks pass and the final report states changed files, validation evidence and unresolved items.
+35
View File
@@ -0,0 +1,35 @@
# Current state
## Current milestone
[Milestone and objective]
## Completed scope
- ...
## Changed modules
- ...
## Validation evidence
| Command/check | Result | Notes |
|---|---|---|
| ... | PASS/FAIL/NOT RUN | ... |
## Browser verification
- ...
## Migrations/configuration
- ...
## Open risks and blockers
- ...
## Next action
- ...
+44
View File
@@ -0,0 +1,44 @@
# DevRunbook final handoff
## Delivered product
[Concise production-level summary.]
## Release identity
- Version:
- Commit:
- Database schema version:
- Container image digest:
## Verified capabilities
- ...
## Validation evidence
| Gate | Result | Evidence |
|---|---|---|
| Clean installation | | |
| Migrations | | |
| Built-in catalog | | |
| Core browser flows | | |
| Backup/restore | | |
| Security checks | | |
| Performance targets | | |
## Deployment
[Exact supported deployment path and important environment settings.]
## Known limitations
- ...
## Deferred roadmap
- ...
## Operator actions
- ...
+36
View File
@@ -0,0 +1,36 @@
# Milestone report — [name]
## Outcome
[What user-visible or architectural capability now exists.]
## Scope delivered
- ...
## Key decisions
- ...
## Validation
- Formatting: ...
- Lint: ...
- Typecheck: ...
- Unit tests: ...
- Integration tests: ...
- Build: ...
- Browser checks: ...
- Security checks: ...
## Evidence artifacts
- ...
## Limitations
- ...
## Next milestone
- ...
+30
View File
@@ -0,0 +1,30 @@
apiVersion: devrunbook.io/v1alpha1
kind: EvaluationCase
metadata:
id: category.playbook.case-name
version: 1.0.0
spec:
playbookVersion: 1.0.0
fixture:
repository: fixtures/example-repository
digest: replace-with-sha256
profile: fixtures/example-profile.yaml
inputs:
example: value
autonomyLevel: verify
expectedPrompt:
requiredHeadings:
- Mission
- Scope
- Constraints and guardrails
- Validation plan
- Completion contract
requiredPatterns: []
prohibitedPatterns:
- BEGIN PRIVATE KEY
- Authorization: Bearer
deterministic: true
futureExecutionRubric:
protectedPathsUnchanged: true
requiredCommands: []
expectedArtifacts: []
@@ -0,0 +1,5 @@
# Changelog
## 0.1.0
- Initial draft package.
+5
View File
@@ -0,0 +1,5 @@
# Playbook Package authoring skeleton
Copy this directory to `content/playbooks/<slug>/`, rename `playbook.yaml.template` to `playbook.yaml` and replace every `${...}` authoring token. Rename the other `.template` files to their final names and declare them in `package.files`.
The template is deliberately not accepted as runtime content. A completed package must validate against `schemas/playbook.schema.json`, include no unresolved authoring tokens and pass `python3 scripts/validate_pack.py`.
@@ -0,0 +1,12 @@
apiVersion: devrunbook.io/v1alpha1
kind: EvaluationCase
metadata:
id: ${slug}.static-structure
version: 1.0.0
spec:
playbookVersion: 0.1.0
inputFile: ../examples/minimal.yaml
expectedHeadings: [Mission, Scope, Constraints, Workflow, Validation, Completion contract, Final report]
prohibitedPatterns: [BEGIN PRIVATE KEY]
deterministic: true
expectedLintStatus: warning
@@ -0,0 +1,7 @@
playbook:
slug: ${slug}
version: 0.1.0
workMode: plan
autonomyLevel: plan
inputs:
taskContext: ${A representative non-sensitive task description.}
@@ -0,0 +1,111 @@
apiVersion: devrunbook.io/v1alpha1
kind: Playbook
metadata:
id: ${category}.${logical-id}
slug: ${slug}
version: 0.1.0
title: ${Title}
summary: ${A concise summary of the problem and outcome.}
category: ${category}
tags: [${tag}]
lifecycle: draft
riskTier: moderate
authors:
- name: ${Author}
license: MIT
package:
files:
- path: prompt.md
role: template
digest: true
exportByDefault: false
- path: README.md
role: documentation
digest: true
exportByDefault: false
- path: CHANGELOG.md
role: changelog
digest: true
exportByDefault: false
- path: examples/minimal.yaml
role: example
digest: true
exportByDefault: false
- path: evaluations/static-structure.yaml
role: evaluation
digest: true
exportByDefault: false
spec:
type: guided
intent:
problem: ${Describe the failure mode this playbook prevents.}
outcome: ${Describe the observable result.}
whenToUse: [${Use case}]
whenNotToUse: [${Exclusion}]
modes: [inspect, plan]
defaultMode: plan
autonomy: {min: observe, max: plan, default: plan}
inputs:
- key: taskContext
label: Task context
description: ${Describe the required user context.}
type: multiline
required: true
sensitive: false
includeInOutput: true
compatibility:
repositoryRequired: true
languages: []
frameworks: []
packageManagers: []
databases: []
deploymentTypes: []
requiredProfileCapabilities: []
incompatibleConditions: []
guardrails:
- id: bounded-scope
severity: blocking
text: Keep investigation and recommendations within the declared task scope.
workflow:
- id: inspect
title: Inspect relevant evidence
instruction: Read repository guidance and gather bounded evidence before conclusions.
required: true
validation:
commandRoles: []
checks:
- id: evidence
type: assertion
description: Every material conclusion references evidence or an explicit unknown.
blocking: true
evidence: Final evidence table.
completion:
criteria: [The requested outcome is evidenced and remaining uncertainty is explicit.]
failurePolicy:
onValidationFailure: Report the failed check, preserve evidence and do not claim completion.
onAmbiguity: State the narrowest safe assumption and record its effect on the result.
onMissingContext: Continue only with bounded inspection and identify the missing context.
onOutOfScopeCause: Document the cause and propose a separate scoped follow-up task.
onExternalDependencyUnavailable: Use available local evidence and mark external checks as not run.
onUnableToReproduce: Preserve reproduction evidence and report the smallest next diagnostic step.
reporting:
sections:
- id: summary
title: Summary
required: true
- id: evidence
title: Evidence and validation
required: true
template:
main: prompt.md
partials: []
exports:
prompt: true
markdown: true
runPack: true
agentsSuggestion: false
quality:
reviewStatus: unreviewed
testedStacks: []
knownLimitations: [This draft has not yet been evaluated on a fixture repository.]
evaluationCaseIds: [${slug}.static-structure]
@@ -0,0 +1,12 @@
# ${Title} — playbook-specific context
## User-provided task context
{{ inputs.taskContext }}
## Task-specific emphasis
- ${First bounded instruction}
- ${Second bounded instruction}
The platform composition engine adds authoritative scope, autonomy, validation, failure handling and reporting around this context.
+746
View File
@@ -0,0 +1,746 @@
{
"schemaVersion": 1,
"product": "DevRunbook",
"release": {
"version": "0.0.0-unreleased",
"commit": "0000000",
"generatedAt": "2026-07-27T00:00:00Z",
"overallStatus": "blocked"
},
"summary": {
"passed": 0,
"failed": 0,
"blocked": 68,
"notApplicable": 0,
"acceptedExceptions": 0
},
"requirements": [
{
"requirementId": "FR-LIB-001",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-LIB-002",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-LIB-003",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-LIB-004",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-LIB-005",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-LIB-006",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-LIB-007",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-LIB-008",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-DET-001",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-DET-002",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-DET-003",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-DET-004",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-DET-005",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-DET-006",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-DET-007",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-REP-001",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-REP-002",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-REP-003",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-REP-004",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-REP-005",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-REP-006",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-REP-007",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-REP-008",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-001",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-002",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-003",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-004",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-005",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-006",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-007",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-008",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-009",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-COM-010",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-OUT-001",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-OUT-002",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-OUT-003",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-OUT-004",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-OUT-005",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-OUT-006",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-OUT-007",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-OUT-008",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-AUT-001",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-AUT-002",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-AUT-003",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-AUT-004",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-AUT-005",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-AUT-006",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-AUT-007",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-AUT-008",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-GIT-001",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-GIT-002",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-GIT-003",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-GIT-004",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-GIT-005",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-GIT-006",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-GIT-007",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-GIT-008",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-QUA-001",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-QUA-002",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-QUA-003",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-QUA-004",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-QUA-005",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-QUA-006",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-ADM-001",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-ADM-002",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-ADM-003",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-ADM-004",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
},
{
"requirementId": "FR-ADM-005",
"status": "blocked",
"commit": null,
"testEvidence": [],
"browserEvidence": [],
"exceptionId": null,
"notes": "Not yet evaluated."
}
],
"gates": [
{
"id": "build-pack-validation",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "format-lint-typecheck",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "unit-tests",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "integration-tests",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "contract-tests",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "security-tests",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "browser-tests",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "production-build",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "container-health",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "fresh-database-migration",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "golden-prompt-conformance",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "clean-room-install",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "backup-restore",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "performance-report",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "dependency-license-secret-scans",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
},
{
"id": "documentation-handoff",
"status": "blocked",
"evidence": [
"Not yet evaluated."
]
}
],
"artifacts": []
}