Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

docs(rules): allow unit tests under scripts/tests/ on conditions instead of forbidding them

hugohe38e5be7c05989
diff --git a/AGENTS.md b/AGENTS.md
index 26824139..7b976bbe 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -49,7 +49,7 @@ PPT Master turns source material into natively editable DrawingML PPTX. Generate
## Compatibility Boundary
- This repository is a workflow/skill package, not an app or service scaffold.
-- Do NOT assume generic-project conventions like `.worktrees/`, `tests/`, or mandatory branch setup unless the user explicitly requests them.
+- Do NOT assume generic-project conventions like `.worktrees/`, CI, or mandatory branch setup unless the user explicitly requests them. The only test location is `skills/ppt-master/scripts/tests/` under the conditions in [`docs/rules/code-style.md`](docs/rules/code-style.md) §11.
- On conflict with a generic coding skill, prioritize [`skills/ppt-master/SKILL.md`](skills/ppt-master/SKILL.md) inside this repository.
## Command Quick Reference
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 597aa5d3..ac249cda 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -80,7 +80,7 @@ If you're unsure, open an issue to ask — that's always welcome.
1. **Fork** the repository and create a branch from `main`
2. **One PR, one thing** — keep each PR focused on a single concern. If you notice unrelated improvements, open a separate PR
3. **Write a useful PR description** — explain *what* changed and *why*, not just a diff summary. If your change fixes a bug, include reproduction steps
-4. **Test locally** before submitting — run the affected scripts and verify output
+4. **Test locally** before submitting — run the affected scripts on a real project and show the output. Unit tests are optional and live only under `skills/ppt-master/scripts/tests/` on the standard library `unittest` (see [`docs/rules/code-style.md`](docs/rules/code-style.md) §11); a green suite does not replace the real-project run
5. **Don't overstate** — if your PR description claims tests or behavior changes, make sure the diff actually contains them
## Review Process
diff --git a/docs/rules/code-style.md b/docs/rules/code-style.md
index 189b2b28..48194043 100644
--- a/docs/rules/code-style.md
+++ b/docs/rules/code-style.md
@@ -261,22 +261,22 @@ def classify_license(
## 11. Testing
-**Hard rule**: this repository does **not** ship automated tests.
+**Default — tests are allowed only under `skills/ppt-master/scripts/tests/` (may override only by editing this rule)**. The repository stays a workflow/skill package: no CI, no pytest, no coverage tooling, no merge gate. Tests exist so that a checker/exporter fix can be re-run in seconds after the next fix lands; they are a regression net, not a substitute for running the real thing.
-**Forbidden**:
+**Allowed**:
-- `tests/` directories
-- `test_*.py` files
-- `unittest` / `pytest` imports
-- `if __name__ == "__main__":` blocks that run a self-test suite
+- `skills/ppt-master/scripts/tests/test_<topic>.py` modules on the standard library `unittest`, run one module at a time: `cd skills/ppt-master/scripts && python3 -m unittest tests.test_<topic>` (`discover` is not supported here)
+- Cases that exercise `scripts/` Python through its public entry points (CLI `main(argv)`, the converter, the checker) on minimal fixtures built inside the test — a short SVG or JSON string, a temporary directory
+- Mocked network calls; never a live provider request or an installed-package assumption beyond `requirements.txt`
-**Use instead**:
+**Forbidden**:
-- Inline smoke commands via `python3 -c "..."` against real project samples; show the output in the conversation / PR description
-- Manual verification steps in the runbook
-- Live-API smoke runs against `projects/_smoke_*` directories (gitignored)
+- `tests/` directories anywhere else, `test_*.py` next to the code, `pytest` / third-party test frameworks, `if __name__ == "__main__":` self-test blocks
+- Tests for prompt text, workflow documents, or templates — those are governed by `prompt_audit.py` and review
+- Fixtures that depend on files outside the test module (except the bundled template library under `templates/`)
+- Treating a green suite as verification: a change to conversion behaviour is still smoke-run against a real project (`python3 -c "..."`, `svg_quality_checker.py`, `svg_to_pptx.py` on a `/tmp` copy) and the output is shown in the conversation / PR description
-This is a deliberate project convention. When external contributors include tests, ask them to remove tests in PR review (see [`docs/rules/prompt-style.md`](./prompt-style.md) §11 for the parallel rule on reference docs).
+Contributors may include tests for the scripts they change; reviewers never require them, and a PR that claims "tests pass" without a real-project smoke run is reviewed as untested (see [`CONTRIBUTING.md`](../../CONTRIBUTING.md)).
---