create-justification

To generate a markdown file for architectural decisions, provide a decision slug and your justification text. The tool creates a uniquely named markdown file with a three-word identifier and frontmatter containing the date and title.

A three-word identifier guarantees filename uniqueness across your repository. This prevents naming collisions when multiple team members document reasoning for various product or strategic choices simultaneously.

Yes, you can automatically add frontmatter to decision documentation markdown files. The generation process inserts the current date and a formatted title based on your provided decision slug directly into the file's metadata.

The best way to track product strategy reasoning is to store documented decisions in a dedicated directory. This skill generates files within the .agents/justifications directory, ensuring your architectural and product choices are consistently tracked.

No external dependencies are required to generate justification files. The skill operates independently using internal scripts to create uniquely named markdown files with the necessary frontmatter and content.

A limitation is that the unique ID is strictly a three-word identifier generated by the script, meaning you cannot supply a custom filename. Additionally, content insertion is limited to the text you provide without further structural formatting.