Metadata-Version: 2.4
Name: fde-workflow-cli
Version: 0.2.0
Summary: Direction framework for FDE customer projects: North Star, KPIs with baselines, paths, stages and decisions, on top of any execution methodology.
License-Expression: MIT
License-File: LICENSE
Keywords: claude-code,cli
Author: Marco Fura Mendoza
Requires-Python: >=3.13,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: pydantic (>=2.14,<3)
Requires-Dist: pyyaml (>=6.0.3,<7)
Requires-Dist: typer (>=0.27,<1.0)
Project-URL: Homepage, https://github.com/mjfura/fde-workflow
Project-URL: Issues, https://github.com/mjfura/fde-workflow/issues
Project-URL: Repository, https://github.com/mjfura/fde-workflow
Description-Content-Type: text/markdown

# fde-workflow-cli

Command line tool of the `fde-workflow` Claude Code plugin: it reads and writes a repository's
FDE direction in `.fde/` and enforces the framework's rules.

```sh
uv tool install fde-workflow-cli    # or: pipx install fde-workflow-cli
fde-workflow --version
fde-workflow doctor                 # checks that everything is ready
```

| Command | Purpose |
|---|---|
| `init`, `detect` | Set up `.fde/`; inspect a repository's methodology and artifacts |
| `status`, `context`, `validate` | Summaries for people and for Claude; rule checks |
| `drift` | Specs, plans or other artifacts that no path links |
| `report status\|close` | Markdown reports in `.fde/reports/` for the sponsor |
| `portfolio`, `portfolio forget` | Every repository on this machine that uses the framework |
| `project set` | The project's name, customer and sponsor |
| `northstar set\|confirm` | The North Star |
| `kpi add\|update\|measure\|due` | KPIs, their recipes, measurements and the ones due |
| `path add\|update\|move\|link\|confirm` | Paths and their links to execution work |
| `stage set\|confirm\|criteria\|decide` | The project stage and its gates |
| `decision add` | Other direction decisions |
| `hook session-start\|post-tool-use` | Entry points of the plugin's hooks |

Run `fde-workflow <command> --help` for the options. `init`, `status`, `validate`, `context` and
the SessionStart hook add the repository to the portfolio registry,
`$XDG_CONFIG_HOME/fde-workflow/projects.json` (default `~/.config/fde-workflow/projects.json`),
which holds repository paths only. Requires Python 3.13 or newer. Source and
plugin: https://github.com/mjfura/fde-workflow

