[media-types] [IANA #1434755] application/vnd.faf+yaml registration request

Hi Alexey,

Would you be able to review this one by November 10th?

thanks,
Amanda

=====

Name: James Wolfe

Email: [email protected]

Media type name: application

Media subtype name: vnd.faf+yaml

Required parameters: N/A

Optional parameters: Format version (e.g., version=1.0)

Encoding considerations: 8bit

UTF-8 encoding required. Binary content may be base64-encoded within YAML structure.

Security considerations: Security considerations:
.faf files contain project metadata and configuration information. Implementations should:
- Validate YAML structure before parsing
- Sanitize file paths to prevent directory traversal
- Verify score and confidence values are within valid ranges (0-100, 0-1.0)
- Not execute code contained in .faf files
- Treat content as untrusted user input

Privacy: .faf files may contain project-specific information including dependencies,
architecture details, and development workflows. Sensitive information should not be
included in publicly shared .faf files.

Interoperability considerations: Interoperability considerations:
.faf extends YAML with specific structure for AI context representation. All .faf files
are valid YAML documents. Standard YAML parsers can read .faf files, though specialized
parsers are recommended for validation and scoring features.

Cross-platform compatibility achieved through:
- Platform-agnostic YAML format
- UTF-8 encoding
- No platform-specific path conventions in core specification

Published specification: https://github.com/Wolfe-Jam/faf (primary specification)
https://faf.one (documentation and reference implementation)

Applications which use this media: - faf-cli: Command-line tool for .faf generation and validation
- claude-faf-mcp: Anthropic Model Context Protocol server (official MCP registry)
- AI development environments: Claude Code, OpenAI Codex, Google Gemini
- IDE integrations: VS Code, Cursor
- Chrome Extension for GitHub integration

Fragment identifier considerations: N/A

Restrictions on usage: None (MIT License, open source)

Provisional registration? (standards tree only): No

Additional information:

1. Deprecated alias names for this type: N/A
2. Magic number(s): Files typically begin with YAML structure starting with "version:" key or YAML document marker "---"
3. File extension(s): .faf
4. Macintosh file type code: N/A
5. Object Identifiers: N/A

General Comments: .faf is designed as a universal format for AI project context representation across all development environments and AI platforms. Current adoption includes official integration with Anthropic's Model Context Protocol ecosystem, 9,900+ npm package downloads, and validation across major AI platforms (Claude, OpenAI Codex, Google Gemini). The format addresses fundamental AI context incompleteness in software development workflows.

Person to contact for further information:

1. Name: Wolfe James
2. Email: [email protected]

Intended usage: COMMON

Author/Change controller: Wolfe James
Creator and Maintainer, .faf Format Specification
Email: [email protected]
ORCID: 0009-0007-0801-3841
GitHub: https://github.com/Wolfe-Jam/faf

_______________________________________________
media-types mailing list -- [email protected]
To unsubscribe send an email to [email protected]