Skip to content

AGENTS.md

Latest commit

 

History

History
59 lines (42 loc) · 2.25 KB

AGENTS.md

File metadata and controls

59 lines (42 loc) · 2.25 KB
Raw

DeckForge Agent Entry Point

This repository contains Agent Skills and reference scaffolds for reliable editable, browser-native slide applications.

Code intelligence

Prefer Serena semantic tools for source-code navigation, symbol lookup, references, implementations, dependency tracing, and symbol-level refactoring.

Use built-in read/grep tools for configuration files, documentation, logs, plain-text searches, or when Serena cannot resolve the required code context.

Read order

  1. rules/README.md
  2. rules/repository-boundaries.md
  3. rules/design-quality.md
  4. rules/security-rules.md
  5. the relevant skills/*/SKILL.md
  6. skills/deckforge/references/delivery-acceptance-contract.md for implementation work

Default routing

  • Use skills/deckforge/SKILL.md for creating, redesigning, extending, or migrating a presentation product.
  • Use skills/deckforge-audit/SKILL.md for review-only work.
  • Use skills/deckforge-runtime-planner/SKILL.md for architecture planning without implementation.
  • Use skills/deckforge-publish/SKILL.md for publishing, embedding, and delivery.
  • Use skills/deckforge-visual-evidence/SKILL.md for browser-based verification of a generated application and for producing executed capability evidence.
  • Use skills/deckforge-skill-evaluator/SKILL.md for comparing skill conditions and gatekeeping skill releases.

For ordinary end-user requests to create slides, select the editable-deck profile unless the user explicitly asks for a presenter-only artifact.

Non-negotiable implementation rules

  • Use semantic layout slots rather than arbitrary coordinates by default.
  • Do not claim an editor exists unless controls mutate DeckProject state and changes persist.
  • Keep the editor and presenter as separate surfaces.
  • Provide visible shortcut guidance.
  • Run schema, layout, output-contract, build, and behavioral checks before completion.

Plugin discovery

  • .agents/plugins/marketplace.json
  • .claude-plugin/plugin.json
  • .codex-plugin/plugin.json

Validation

npm run validate
npm run package-skills

Target-project checks:

python scripts/audits/audit_deck_layout.py <deck.json> --strict
python scripts/audits/validate_output_contract.py <project-directory> --profile editable-deck