Skip to content

Tenka Examples

Example scopes can define functional requirements in tenka.yml.

python-general stories

Defines foundational stories for any Python project:

# example-daimyo-rules/python-general/tenka.yml
tenka:
  US001:
    who: Python Developer
    what: a clean development environment
    why: I can work efficiently without side effects
    acs:
      AC001.1:
        given: a fresh clone
        when: I run the setup script
        then: a virtual environment is created and all dependencies are installed

project-api stories

Inherits from python-general and adds project-specific vision:

# example-daimyo-rules/project-api/tenka.yml
tenka:
  US101:
    who: API Consumer
    what: consistent error responses
    why: I can handle failures programmatically across all endpoints
    acs:
      AC101.1:
        when: an error occurs
        then: the response follows RFC 7807 (Problem Details for HTTP APIs)

Exploring the Examples

# Query Tenka (User Stories and ACs)
daimyo get-user-stories python-general
daimyo get-acceptance-criteria python-general --stories US123
daimyo get-validation-status python-general