mirror of https://github.com/penpot/penpot.git synced 2026-09-19 10:26:14 +00:00

Andrey Antukh 8a3540336b 📚 Add local-ci skill and scripts/ci memory

Teach agents to verify their changes with ./scripts/ci: module list,
task selection flags, log locations under .ci-logs/, and per-module
workflows (lint-only pass, --fix, --paren-repair, common/ consumer
checks). Register the skill in the skills README, point AGENTS.md at
the new memory, and add the script to the critical-info dev scripts.

AI-assisted-by: omen-alpha

2026-09-09 11:01:49 +02:00

2.5 KiB

Raw Blame History

CI (scripts/ci)

scripts/ci runs CI-style checks — lint, tests, format — for one or more monorepo modules and prints a per-task summary. It is the local equivalent of CI; use it to verify changes before declaring work done.

When to use

After implementing or fixing code in a module: run its checks before finishing (AGENTS.md: run the applicable lint and format checks).
When common/ changed: validate its consumers too (frontend, backend, exporter; see the dependency graph in mem:critical-info).
To fix formatting across a module (--fix) or repair delimiters (--paren-repair) before linting.

How to use (CLI)

Run from the repo root:

./scripts/ci MODULE...                  # lint + test + fmt per module
./scripts/ci --all --no-test            # lint + fmt on all modules
./scripts/ci --lint frontend            # lint only
./scripts/ci --fix --no-test frontend   # format files, skip tests
./scripts/ci --paren-repair --all       # fix delimiters in all Clojure modules
./scripts/ci --dry-run --all            # preview what would run

Modules: frontend backend common render-wasm exporter mcp plugins library.

Flags:

Default tasks: lint, test, fmt (format check; --fix formats instead).
--lint / --test / --fmt run one task only; --no-lint / --no-test / --no-fmt drop one task from the default set.
--paren-repair runs only the delimiter repair — it wraps scripts/paren-repair over each module's Clojure/CLJS sources; see mem:scripts/paren-repair.
--all selects every module; --exclude MOD drops one (repeatable).
--fail-fast stops at the first failure; --quiet suppresses failure output; --dry-run prints commands without running; --clean removes the log directory.

Logs and exit codes

Full output of every task: .ci-logs/<module>-<task>.log.
On failure the script prints the last 30 lines; the final summary lists every failed module:task with its log path.
Exit code 0 when all selected tasks passed, 1 otherwise.
Diagnose failures by reading the log file — never pipe test output through filters (AGENTS.md hard rule).

Notes

mcp has no lint task (shows as skipped). render-wasm uses ./lint, ./test, and cargo fmt.
Test tasks are long-running (backend: clojure -M:dev:test); use a generous timeout when calling it from an agent shell.
Skill entry point: .agents/skills/local-ci/SKILL.md.
Testing principles and output discipline: mem:testing.

2.5 KiB Raw Blame History