Prompt file imported from SatoryKono/bioactivity_data_acquisition (.windsurf/workflows/00-core-principles.md). Copyright stays with the author.

Core Principles

Name: 00-core-principles
Author: SatoryKono

Scope:

Always apply core project invariants (determinism, schemas, logging, CI discipline)

Treat as global invariant; apply in all tasks, even without matching files.

Purpose

Enforce non-negotiable invariants across the whole repo so the agent does not guess.

Principles (mandatory)

Deterministic I/O: identical inputs+config produce bit-identical outputs. Use stable row/column order, UTC timestamps, canonical JSON, atomic writes.
Validate-before-write: every table is validated against a Pandera schema with fixed column order. No writes on validation failure.
Structured logging only via UnifiedLogger; no print(); include run context and mandatory fields.
Tests: no network in unit tests; golden tests for critical outputs; property-based tests for transformations; coverage ≥ 85% in CI.
API access only through UnifiedAPIClient with retry/backoff, rate limiting, circuit breaker and strict timeouts.
One source → one public pipeline; use unified components (Logger, Writer, Client, Schema); follow extract→transform→validate→export.
Secrets in env/secret manager only; typed configs via Pydantic; profiles for shared defaults; CI secret scanning enabled.
Python style: ruff/black, isort, mypy --strict; no wildcard imports, no global mutable state, no magic numbers.

When to use

Always. Treat as global constraints for planning, codegen, edits and refactors.

Do

Refuse to emit write code without prior schema validation and deterministic sorting.
Bind run context once, log with structured key-value.
Fail fast on missing config or secret.
Prefer composition over inheritance in components.

Don't

Don't emit print(), ad-hoc logging, local time, non-atomic writes, or unordered CSV/JSON.
Don't call external APIs outside UnifiedAPIClient or without throttling/retry policy.
Don't bypass tests or lower coverage thresholds.

Reference

See docs/INDEX.md for overview and docs/styleguide/ for detailed style guides.

# Core Principles > Scope: > - Always apply core project invariants (determinism, schemas, logging, CI discipline) > - Treat as global invariant; apply in all tasks, even without matching files. ## Purpose Enforce non-negotiable invariants across the whole repo so the agent does not guess. ## Principles (mandatory) - Deterministic I/O: identical inputs+config produce bit-identical outputs. Use stable row/column order, UTC timestamps, canonical JSON, atomic writes. - Validate-before-write: every table is validated against a Pandera schema with fixed column order. No writes on validation failure. - Structured logging only via UnifiedLogger; no print(); include run context and mandatory fields. - Tests: no network in unit tests; golden tests for critical outputs; property-based tests for transformations; coverage ≥ 85% in CI. - API access only through UnifiedAPIClient with retry/backoff, rate limiting, circuit breaker and strict timeouts. - One source → one public pipeline; use unified components (Logger, Writer, Client, Schema); follow extract→transform→validate→export. - Secrets in env/secret manager only; typed configs via Pydantic; profiles for shared defaults; CI secret scanning enabled. - Python style: ruff/black, isort, mypy --strict; no wildcard imports, no global mutable state, no magic numbers. ## When to use Always. Treat as global constraints for planning, codegen, edits and refactors. ## Do - Refuse to emit write code without prior schema validation and deterministic sorting. - Bind run context once, log with structured key-value. - Fail fast on missing config or secret. - Prefer composition over inheritance in components. ## Don't - Don't emit print(), ad-hoc logging, local time, non-atomic writes, or unordered CSV/JSON. - Don't call external APIs outside UnifiedAPIClient or without throttling/retry policy. - Don't bypass tests or lower coverage thresholds. ## Reference See [docs/INDEX.md](../../docs/INDEX.md) for overview and [docs/styleguide/](../../docs/styleguide/) for detailed style guides.

{ "prompt": "# Core Principles\n\n> Scope:\n> - Always apply core project invariants (determinism, schemas, logging, CI discipline)\n> - Treat as global invariant; apply in all tasks, even without matching files.\n\n## Purpose\n\nEnforce non-negotiable invariants across the whole repo so the agent does not guess.\n\n## Principles (mandatory)\n\n- Deterministic I/O: identical inputs+config produce bit-identical outputs. Use stable row/column order, UTC timestamps, canonical JSON, atomic writes.\n- Validate-before-write: every table is validated against a Pandera schema with fixed column order. No writes on validation failure.\n- Structured logging only via UnifiedLogger; no print(); include run context and mandatory fields.\n- Tests: no network in unit tests; golden tests for critical outputs; property-based tests for transformations; coverage ≥ 85% in CI.\n- API access only through UnifiedAPIClient with retry/backoff, rate limiting, circuit breaker and strict timeouts.\n- One source → one public pipeline; use unified components (Logger, Writer, Client, Schema); follow extract→transform→validate→export.\n- Secrets in env/secret manager only; typed configs via Pydantic; profiles for shared defaults; CI secret scanning enabled.\n- Python style: ruff/black, isort, mypy --strict; no wildcard imports, no global mutable state, no magic numbers.\n\n## When to use\n\nAlways. Treat as global constraints for planning, codegen, edits and refactors.\n\n## Do\n\n- Refuse to emit write code without prior schema validation and deterministic sorting.\n- Bind run context once, log with structured key-value.\n- Fail fast on missing config or secret.\n- Prefer composition over inheritance in components.\n\n## Don't\n\n- Don't emit print(), ad-hoc logging, local time, non-atomic writes, or unordered CSV/JSON.\n- Don't call external APIs outside UnifiedAPIClient or without throttling/retry policy.\n- Don't bypass tests or lower coverage thresholds.\n\n## Reference\n\nSee [docs/INDEX.md](../../docs/INDEX.md) for overview and [docs/styleguide/](../../docs/styleguide/) for detailed style guides.", "variables": [], "notes": "Enforce non-negotiable invariants across the whole repo so the agent does not guess.", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/SatoryKono/bioactivity_data_acquisition", "path": ".windsurf/workflows/00-core-principles.md", "ref": "98f17f432532cddd56d0a07fd4796b37c54677ec", "url": "https://github.com/SatoryKono/bioactivity_data_acquisition/blob/98f17f432532cddd56d0a07fd4796b37c54677ec/.windsurf/workflows/00-core-principles.md", "key": "SatoryKono/bioactivity_data_acquisition/.windsurf/workflows/00-core-principles.md" } } }

00-core-principles

About

Core Principles

Purpose

Principles (mandatory)

When to use

Do

Don't

Reference

Use it

Manifest

Reviews