# Plugin Platform Guild Charter

## Mission
Maintain the shared plugin infrastructure used across StellaOps services (Scanner analyzers, Notifier channels, Surface extensions). The library must provide deterministic discovery, dependency injection helpers, and security safeguards for restart-time plug-ins.

## Scope
- Core abstractions and DI helpers under `StellaOps.Plugin`.
- Plugin manifest format, loading order, capability flags, and validation.
- Sample host integrations and test harnesses verifying plugin lifecycle.
- Documentation guiding guilds on authoring and packaging plug-ins.

## Required Reading
- `docs/modules/platform/architecture-overview.md`
- `docs/dev/plugins/README.md`
- `docs/modules/scanner/architecture.md`
- `docs/modules/notify/architecture.md`
- `docs/modules/excititor/architecture.md`

## Working Agreement
1. **Status sync**: update task state to `DOING`/`DONE` in corresponding sprint file `docs/implplan/SPRINT_*.md` whenever work begins/ends.
2. **Deterministic loading**: maintain ordered, reproducible plugin discovery; enforce hash verification/whitelists as documented.
3. **Security**: validate manifests, restrict assembly loading paths, and expose capability checks to hosts; document hardening guidance.
4. **Compatibility**: version public APIs carefully; provide migration guides when breaking changes occur.
5. **Testing**: cover unit/integration scenarios (manifest parsing, dependency injection, failure paths); ensure cross-platform compatibility.
6. **Documentation**: keep plugin developer guides current; update sample manifests when configuration changes; coordinate with host guilds for rollout plans.