plugins/_promptinclude/AGENTS.md

Prompt Include Plugin DOX

Purpose

• Own automatic prompt injection of persistent behavioral rules and preferences from *.promptinclude.md files.

Ownership

• helpers/scanner.py owns workspace scanning, ignore handling, token budgeting, and trimming.
• prompts/ owns prompt-inclusion fragments.
• extensions/ owns prompt injection hooks.
• default_config.yaml, plugin.yaml, README.md, and webui/ own defaults, metadata, behavior notes, and settings UI.

Local Contracts

• Respect gitignore-style filtering, per-file budgets, and total token budgets.
• Include only intended promptinclude files from configured workspaces.
• Keep scan result status fields accurate for skipped, cropped, and included files.

Work Guidance

• Coordinate scanner changes with prompt fragments so included content is clearly attributed.

Verification

• Smoke-test include, ignore, crop, and over-budget cases after scanner changes.

Child DOX Index

No child DOX files.