The tasks below cover project creation, routine feature development, structural improvements, and additional tests. The Agent component sends the complete prompt to the selected application; you can also copy and adapt it to your project.
Create a new func project
Suitable scenarios
This workflow is for developers using func for the first time and teams that want to establish an isolated CLI package inside an existing monorepo. Open the target repository in your coding agent; you do not need to check Node.js, package-manager, or workspace configuration one item at a time.
>_
Ask an agent to create a func project
Create and verify a runnable project named func-example in the current repository.
Read https://func.witt.im/setup.txt and the project instructions in the current repository first.
Create a func CLI project named func-example in this repository. Choose the directory and package manager, install environment or project dependencies when needed, and run the default command. Summarize the changes and result.
Common development scenarios
Suitable scenarios
Use this workflow once the func project runs. Give the agent the expected invocation, required fields, conditional behavior, and test expectations so it can implement a standard feature within the existing structure. The two tasks below use ship create; copy them directly or replace the command and behavior with your own.
>_
Ask an agent to add the create command
Add ship create --file document.txt with file as a required path.
Read https://func.witt.im/rules.txt and the project instructions in the current repository first.
Add ship create --file document.txt to the current func CLI. Require --file, create the file, and report clear errors for invalid or existing paths. Follow the current structure, test success and a missing --file, then run the relevant checks.
>_
Ask an agent to add the --ensure option
Add --ensure so the create command writes the file only when explicitly enabled.
Read https://func.witt.im/rules.txt and the project instructions in the current repository first.
Add --ensure to create. Write the file when it is present; otherwise only print the target path. Test both branches, preserve other behavior, and run the relevant checks.
Improve an existing func project
Suitable scenarios
This workflow is for maintainers of a working func project. Use it when commands keep accumulating, handlers have started to own business logic, or source files and generated output are mixed together. The agent should improve the structure without changing CLI behavior.
>_
Ask an agent to improve the project structure
Reorganize entry, module, command, and service boundaries without changing CLI behavior.
Read https://func.witt.im/rules.txt and the project instructions in the current repository first.
Organize the current func project's entry, modules, commands, services, and generated output according to rules.txt without changing commands, output, or scripts. Update imports, module registration, and test paths, then run the relevant checks and report the result.
Add tests for CLI commands
Suitable scenarios
This workflow is for maintainers adding commands, preparing a release, or finishing a structural refactor. It protects the behavior your CLI promises to users instead of re-testing func internals, making it useful as regression coverage before merging code.
>_
Ask an agent to add CLI tests
Add acceptance coverage for commands, aliases, option constraints, and owned failures.
Read https://func.witt.im/rules.txt and the project instructions in the current repository first.
Review the current commands and tests, then add missing user-visible coverage for command paths, aliases, successful output, option constraints, and application errors. Prefer func/testing and assert exit codes plus stable output. Run the relevant tests and report the result.
Reference
You can also ask an AI to read llms.txt, use its documentation index to find the relevant capability, and complete the development task. This is usually enough for common project setup, command, option, validation, and testing work.
