afc-toolkit - GitLite

KO | EN

gitlite — search

#awesome-list #codex #monitoring #tensorflow #electron #chatgpt #markdown #c #tailwindcss #pytorch

afc-toolkit

(★ 13)

WOAFC Toolkit — selected-user Codex audit plugin for product, workflow and system steering.

File Explorer

ZIP Download

- - marketplace.json
- - bug_report.yml
  - config.yml
  - feature_request.yml
- - validate.yml
- - CHANGELOG.md
  - LICENSE
  - README.md
- baseline-template.md
- README.md
- release.py
- test_ci_contract.py
- test_release.py
.gitignore
.gitlab-ci.yml
CONTRIBUTING.md
PRIVACY.md
README.md
README.vi.md
RELEASING.md
SECURITY.md
SUPPORT.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`codex`

View Details ▼

Natural language code assistant for the terminal, powered by OpenAI.
Reads and edits files in your current directory to fulfill requests.

codex

Start an interactive Codex session in the current directory:

codex "{{prompt}}"

Run a single Codex command using a prompt:

codex --sandbox workspace-write "{{prompt}}"

Run a prompt allowing Codex to edit files in the workspace:

🔍

`python3`

View Details ▼

This command is an alias of `python`.

tldr python

View documentation for the original command:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

WOAFC Toolkit is a Vietnamese-first, evidence-first Codex plugin for auditing products, workflows, interfaces, engineering quality, privacy, market evidence, metrics, and release readiness.

This checkout is the **`0.6.0` public-beta release candidate**. Public beta begins only after the versioned runtime and cohort gates pass and the immutable `v0.6.0` tag resolves to the same commit on both release mirrors. The candidate does not claim production-grade auto-trigger accuracy, compliance certification, or verified support in Claude/Cowork and other hosts.

The `research-interview` skill in this feature branch is **Unreleased** and planned for `0.7.0`; it is not part of the `v0.6.0` candidate or its support claims.

[Đọc bằng tiếng Việt](README.vi.md) · [Public beta guide](plugins/woafc-toolkit/docs/public-beta-guide.md) · [Skill catalog](plugins/woafc-toolkit/README.md) · [Changelog](plugins/woafc-toolkit/CHANGELOG.md)

## Good fit

Use WOAFC when you need:

- An evidence-backed product, workflow, system, or release audit.
- A focused interface, engineering, privacy, cultural-content, metrics, or market-evidence review.
- Realistic user simulation with clear separation from real user research.
- Consent-gated design, live conduct, and evidence-safe synthesis of real qualitative research interviews.
- Context, drift, decision, or remediation diagnosis for an agentic project.
- A saved local report with findings, acceptance criteria, and an implementation plan.

Use the base coding assistant for routine implementation, formatting, simple commands, or fixes with clear acceptance criteria.

## Install after `v0.6.0` is published

After the entry gates pass and the immutable tag is published, choose **one** release mirror. Both commands pin the marketplace snapshot to `v0.6.0`; they are not candidate-checkout install commands before that tag exists.

GitHub:

```bash
codex plugin marketplace add https://github.com/philngt/afc-toolkit --ref v0.6.0 --sparse .agents/plugins --sparse plugins/woafc-toolkit
codex plugin list --marketplace personal --available --json
codex plugin add woafc-toolkit@personal
```

GitLab:

```bash
codex plugin marketplace add https://gitlab.com/earn393021/woafc-toolkit --ref v0.6.0 --sparse .agents/plugins --sparse plugins/woafc-toolkit
codex plugin list --marketplace personal --available --json
codex plugin add woafc-toolkit@personal
```

Do not add both mirrors to the same Codex profile: both intentionally publish the marketplace name `personal`. If that name already belongs to another marketplace, inspect `codex plugin marketplace list --json` before changing anything and follow the conflict guidance in the [public beta guide](plugins/woafc-toolkit/docs/public-beta-guide.md#marketplace-name-conflict).

Start a new Codex thread after installation so the new skill inventory is loaded.

## Start with one of these

```text
$product-workflow-system-audit audit this repo end to end and give a Go/No-Go recommendation
```

```text
$product-user-simulation-audit simulate realistic users and find the highest-impact journey friction
```

```text
$project-steering context-audit this repo before we make the next decision
```

```text
$research-interview design a discovery interview about churn, then conduct it one question at a time after consent
```

## Research interviews (Unreleased `0.7.0`)

`research-interview` supports three bounded modes:

- `design`: create the research brief, participant criteria, consent script, question map, interview guide, and analysis plan.
- `conduct`: run a consent-gated interview with a real participant, exactly one question per turn, adaptive branches, shared-understanding checkpoints, and immediate `skip`, `pause`, correction, or withdrawal control.
- `synthesize`: code eligible transcripts or redacted notes into traceable themes, counter-evidence, limitations, decision implications, and research gaps.

Participation consent and raw-transcript storage consent are separate decisions. The skill never simulates a participant, recommends an answer, or treats interview statements as population or market proof. When the user requests saved artifacts, the study bundle uses `.toolkit/research-interviews/YYYYMMDD/<study-slug>/`; redacted notes are the default and raw transcripts require explicit raw-storage consent.

## SwiftUI workflow audit (Unreleased `0.7.0`)

`ui-usecase-discovery` now provides the `ui-workflow-audit` vertical slice: repository-wide SwiftUI discovery, feature screen graphs, bounded state matrices and journeys, semantic Linux simulation, code-to-UI traces, broken-workflow findings, schema `2.0` reports, and optional native verification packs for an existing UI-test target. It supports iOS and macOS only. Mixed projects skip tvOS, visionOS, and watchOS; projects containing only those targets stop with `unsupported_platform`. Semantic HTML or browser captures are never presented as native SwiftUI proof.

```bash
python3 plugins/woafc-toolkit/scripts/ui_workflow_audit.py run \
  --project <swiftui-project> \
  --output .toolkit/reports/YYYYMMDD/ui-workflow-audit/
```

## Choose the right workflow

| Need | Start with |
| --- | --- |
| Overall product, workflow, MVP, or release decision | `$product-workflow-system-audit` |
| Persona journeys and first-use friction | `$product-user-simulation-audit` |
| Design, conduct, or synthesize real qualitative interviews | `$research-interview` (Unreleased) |
| Screenshot, Figma, video, running UI, or UI-source quality | `$product-interface-audit` |
| iOS/macOS SwiftUI graph, state matrix, journeys, simulation, and code traces | `$ui-usecase-discovery` (Unreleased) |
| Context, drift, root cause, challenge, or durable decision | `$project-steering` |
| Maintainability, tests, architecture, or data flow | `$engineering-quality-audit` |
| Privacy, security, retention, permissions, or threat model | `$security-privacy-audit` |
| Another specialist workflow | See the [complete skill catalog](plugins/woafc-toolkit/README.md#skill-catalog) |

Explicit `$skill` invocation is the most predictable release-candidate and public-beta path. Guarded implicit activation exists for narrow, high-confidence audit intent; it is not production auto-trigger proof.

## Evidence and output contract

Important audits separate `proven`, `partially proven`, `user-asserted`, `assumption`, `needs-evidence`, and `blocked`. Simulated users are never presented as real market validation. Interview statements remain `user-asserted`; a transcript proves what a participant said, not that the claim is true or representative.

When a skill is asked to save an HTML report, the default location is:

```text
.toolkit/reports/YYYYMMDD/
```

Saved HTML reports require a same-folder `<report-stem>-implementation-plan.md`. Existing reports must not be overwritten without confirmation. `.toolkit/` is local and gitignored.

## Compatibility

- Public-beta target: Codex CLI `0.144.x`; release validation records the exact tested version.
- Local release gate: Python `3.10–3.12`.
- Codex CLI `0.142.5`: historical partial runtime evidence for the earlier core flows only.
- Other Codex versions, Claude/Cowork, other hosts, and production auto-trigger behavior: `needs-evidence` unless a versioned runtime record says otherwise.

See the [compatibility matrix](plugins/woafc-toolkit/docs/public-beta-guide.md#3-compatibility-matrix) before reporting a host defect.

## Validate a checkout

From the repository root:

```bash
python3 plugins/woafc-toolkit/scripts/eval_all.py
```

The public-beta gate must end with `soft_launch_gate: PASS`. A `SKIPPED` helper is not a `PASS`; record its reason.

## Release mirrors and authority

- GitHub: <https://github.com/philngt/afc-toolkit>
- GitLab: <https://gitlab.com/earn393021/woafc-toolkit>

For a published version, the two mirrors are equal release sources only when the same version tag resolves to the same commit. GitHub Issues and GitHub Security Advisories are the authoritative support and security channels; GitLab is a distribution mirror, not a second support queue.

## Support and project policy

- [Public-beta release and operations guide](plugins/woafc-toolkit/docs/public-beta-guide.md)
- [Support](SUPPORT.md)
- [Security](SECURITY.md)
- [Privacy](PRIVACY.md)
- [Contributing](CONTRIBUTING.md)
- [Releasing](RELEASING.md)

## Repository layout

- `plugins/woafc-toolkit/`: installable plugin payload.
- `.agents/plugins/marketplace.json`: repository marketplace entry.
- `plugins/woafc-toolkit/skills/`: skill contracts and references.
- `plugins/woafc-toolkit/evals/`: static baselines and scoped runtime evidence.
- `plugins/woafc-toolkit/scripts/`: local validation tools.
- `docs/archive/`: historical records, not active source of truth.

## License

MIT. See [plugins/woafc-toolkit/LICENSE](plugins/woafc-toolkit/LICENSE).