---
name: Formax Script Output Placement
slug: formax-script-output-placement
category: DevOps
description: Formax Script Output Placement guides where generator scripts should write files, keeping generated artifacts out of docs/ and near their owning app or script. Use it when adding or changing scripts with output paths and CI checks.
github: "https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-script-output-placement-workflow"
language: TypeScript
stars: 192
forks: 7
install: "npx degit https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-script-output-placement-workflow ~/.claude/skills/formax-script-output-placement-workflow"
installs_to: ~/.claude/skills/formax-script-output-placement-workflow
source_path: .codex/skills/formax-script-output-placement-workflow/SKILL.md
collection_size: 22
category_size: 1013
collection_url: "https://dirskills.com/collections/yusifeng/formax"
added: 2026-09-06T05:19:19.174Z
last_synced: 2026-09-06T05:19:19.174Z
canonical_url: "https://dirskills.com/skills/formax-script-output-placement"
---

# Formax Script Output Placement

Formax Script Output Placement guides where generator scripts should write files, keeping generated artifacts out of docs/ and near their owning app or script. Use it when adding or changing scripts with output paths and CI checks.

**Install:**

```bash
npx degit https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-script-output-placement-workflow ~/.claude/skills/formax-script-output-placement-workflow
```

## README

# Formax Script Output Placement

## Goal

新增或修改“会写文件”的脚本时，避免把机器产物放到 `docs/`。

## Placement Rules

1. `docs/` 只放文档与静态说明素材，不放机器生成基线/报告。
2. 产物就近放到 owner 目录：
   - app 产物 -> `apps/<name>/perf/`
   - repo 级脚本产物 -> `scripts/baselines/`
   - 临时产物 -> `.tmp/`（gitignored）
3. 生成脚本默认输出路径应指向 owner 目录，不指向 `docs/**`。
4. 建议提供 `--output` 或 `--baseline` 覆盖参数（便于 CI 与本地临时切换路径）。

## Minimal Workflow

1. 先定产物 owner 与默认输出目录。
2. 再写脚本和默认路径（owner-local）。
3. 同步更新 README/learning 里的路径引用。

## Checks

- `node ./scripts/check-docs-artifact-placement.mjs`