FAF FAQs

Question 1

What is AI-readiness scoring and how does FAF use it?

Accepted Answer

FAF's `faf-score` skill calculates your project's AI-readiness on a 0-100% scale and assigns Podium tiers (Bronze to Trophy). The `faf-enhance` skill then guides you with targeted questions and additions to improve your score and reach higher tiers.

Question 2

How do FAF's skills automate workflows with Claude?

Accepted Answer

FAF offers 17 Claude Code skills that activate automatically through natural language queries. Instead of remembering commands, you simply ask Claude (e.g., 'Set up project context'), and the relevant FAF skill executes, providing a seamless, zero-memorization workflow.

Question 3

What is FAF?

Accepted Answer

FAF (FAF Skills) is a suite of Claude Code skills designed to help you create and optimize `project.faf` files. These files act as the 'AI equivalent of package.json', providing structured project DNA to enhance AI's understanding of your codebase.

Question 4

How does FAF improve AI's understanding of my project?

Accepted Answer

By generating IANA-registered `project.faf` YAML files, FAF organizes your project's architecture, stack, and other crucial context. This allows AI to read and comprehend your project's intent and structure efficiently, leading to more accurate and helpful responses.

Question 5

What is a `project.faf` file and why is it important?

Accepted Answer

A `project.faf` file is an IANA-registered (application/vnd.faf+yaml) YAML file that lives in your repository root. It contains critical project information for AI, analogous to how `package.json` informs npm. It's crucial because AI reads this architecture and context *before* the code, optimizing its understanding and performance.

FAF

FAF

Key Features

Use Cases

Key Features

Use Cases