# Open Issue Format (OIF)

> Issues and review comments as files, in any git repository, about anything in it.

An issue is a Markdown file whose directory is its workflow status. Its
filename carries a random six-character identity. Comments are
create-only files. Records may point at any path in the repository. A
board is also a conforming Open Knowledge Format bundle.

## Docs

- [Specification](https://oif.md/SPEC.md): the normative document, RFC 2119 language
- [Agent skill](https://oif.md/skill.md): how to create, move, comment on and close issues
- [Everything in one file](https://oif.md/llms-full.txt): spec and skill concatenated

## Profiles

- [Kanban](https://oif.md/profiles/kanban.md)
- [Scrum](https://oif.md/profiles/scrum.md)
- [Shape Up](https://oif.md/profiles/shape-up.md)

## Schemas

- [board.md](https://oif.md/schema/board.schema.json)
- [issue](https://oif.md/schema/issue.schema.json)
- [column.md](https://oif.md/schema/column.schema.json)
- [comment](https://oif.md/schema/comment.schema.json)