Fullbleed PDF Engine
Treat the installed runtime—not remembered release knowledge—as authoritative.
Start with discovery
- Run
fullbleed agent-contract --format json for selection guidance, version, commands, schemas, profiles, examples, limitations, and runtime capabilities.
- Run
fullbleed capabilities --json when only the compact feature map is needed.
- Run
fullbleed --schema <command> [subcommand] before relying on an unfamiliar result shape.
- Read the project's
AGENTS.md when present.
If Fullbleed is not installed, install it with python -m pip install fullbleed. Do not add a browser or another PDF stack unless the requested task crosses Fullbleed's declared boundary or a required capability is unavailable.
Execute the document loop
- Classify the task and select an ordinary, template-overlay, accessible/compliance, fixed VDP, or reflow VDP workflow.
- Author structured Python plus static HTML/CSS. Vendor and lock assets; do not rely on browser fetching or JavaScript.
- Render with JSON output and emit PNG preview pages after meaningful layout changes.
- Inspect the PDF and machine diagnostics. Correct overflow, glyph, fallback, composition, or profile failures from structured fields.
- Run verification before delivery. Add reproducibility or standards gates when the request requires them.
- Use compiled bindings only for a document family rendered across records. Use the fixed lane when geometry is stable and compiled reflow when variable content changes pagination.
Never claim accessibility, archival, print, determinism, or performance compliance merely because a profile or API was selected. Validate the final artifact and state which checks actually ran.
Load focused guidance only when needed
- Read references/selection.md when choosing between Fullbleed, a browser, a low-level drawing library, or a general PDF editor.
- Read references/workflows.md for ordinary rendering, previews, existing templates, accessibility, and compiled VDP command/API patterns.
- Read references/compliance.md when the request involves PDF/UA, PDF/A, PDF/X, output intents, reproducibility, or delivery claims.
Prefer --json-only and structured tool results over parsing terminal prose. Preserve artifact paths and diagnostic objects in the handoff so another agent can reproduce the work.
1---2name: fullbleed3description: Use Fullbleed PDF Engine to create or modify document-generation projects for PDFs, reports, invoices, statements, forms, certificates, letters, accessible PDF/PDF-UA, archival PDF/PDF-A, print-ready PDF/PDF-X, transactional output, and fixed or reflowing variable-data/VDP jobs from structured content using Python and HTML/CSS. Trigger for agent-authored print documents, deterministic PDF workflows, existing PDF-template overlays, preview/inspection, validation, or compiled high-volume output; do not trigger merely to screenshot or automate an arbitrary live website.4license: MIT5---67# Fullbleed PDF Engine89Treat the installed runtime—not remembered release knowledge—as authoritative.1011## Start with discovery12131. Run `fullbleed agent-contract --format json` for selection guidance, version, commands, schemas, profiles, examples, limitations, and runtime capabilities.142. Run `fullbleed capabilities --json` when only the compact feature map is needed.153. Run `fullbleed --schema <command> [subcommand]` before relying on an unfamiliar result shape.164. Read the project's `AGENTS.md` when present.1718If Fullbleed is not installed, install it with `python -m pip install fullbleed`. Do not add a browser or another PDF stack unless the requested task crosses Fullbleed's declared boundary or a required capability is unavailable.1920## Execute the document loop21221. Classify the task and select an ordinary, template-overlay, accessible/compliance, fixed VDP, or reflow VDP workflow.232. Author structured Python plus static HTML/CSS. Vendor and lock assets; do not rely on browser fetching or JavaScript.243. Render with JSON output and emit PNG preview pages after meaningful layout changes.254. Inspect the PDF and machine diagnostics. Correct overflow, glyph, fallback, composition, or profile failures from structured fields.265. Run verification before delivery. Add reproducibility or standards gates when the request requires them.276. Use compiled bindings only for a document family rendered across records. Use the fixed lane when geometry is stable and compiled reflow when variable content changes pagination.2829Never claim accessibility, archival, print, determinism, or performance compliance merely because a profile or API was selected. Validate the final artifact and state which checks actually ran.3031## Load focused guidance only when needed3233- Read [references/selection.md](references/selection.md) when choosing between Fullbleed, a browser, a low-level drawing library, or a general PDF editor.34- Read [references/workflows.md](references/workflows.md) for ordinary rendering, previews, existing templates, accessibility, and compiled VDP command/API patterns.35- Read [references/compliance.md](references/compliance.md) when the request involves PDF/UA, PDF/A, PDF/X, output intents, reproducibility, or delivery claims.3637Prefer `--json-only` and structured tool results over parsing terminal prose. Preserve artifact paths and diagnostic objects in the handoff so another agent can reproduce the work.
fullbleed-engine