faffter-noon-architecture

Generates a production-grade architecture proposal from a brief and team infrastructure profile.

3|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/shftwst/faff --skill faffter-noon-architecture-shftwst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: faffter-noon-architecture
Source: https://github.com/shftwst/faff/tree/main/plugin/skills/faffter-noon-architecture
Command: npx skills add https://github.com/shftwst/faff --skill faffter-noon-architecture-shftwst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams starting a new feature or system often lack a reasoned, evidence-based architecture proposal that fits their actual infrastructure, forcing them to rely on generic best-practice templates that ignore existing runtimes, CI, and deploy targets. ## Core Features & Use Cases - Profile-Fitted Proposals: Reads the team's infra profile via faff profile show --json and derives the architecture from real evidence (runtimes, CI, deploy targets, stated preferences) rather than generic templates. - Contract-Conformant Output: Emits a single faff-contract:architecture-proposal block with chosen architecture, rationale, ADR candidates, assumptions, and a build/buy-style recommendation, validated by faff contract architecture-proposal. - ADR Promotion Intent: Names decisions worth recording as ADR candidates with title, decision, and rationale, without writing to the ADR directory or calling faff adr new. - Use Case: Given a spec for a new service and an infra profile showing a single Node runtime with CI, the skill proposes a modular monolith, lists assumptions like single-region traffic, and flags ADR candidates for human review. ## Quick Start Ask the agent to propose an architecture for the current brief or spec using the team's existing infrastructure profile.

Frequently Asked Questions about faffter-noon-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an architecture proposal from a project brief?▼

Provide the brief or spec and let the skill read the team's infra profile via faff profile show --json. It emits one faff-contract:architecture-proposal block with the chosen architecture, rationale, ADR candidates, assumptions, and a recommendation.

What happens if no infrastructure profile exists?▼

When faff profile show exits with code 3, the skill records an explicit no-infra-profile assumption and proposes against the brief alone. Profile acquisition is a separate slot's responsibility and is never triggered here.

Does the architecture proposal skill create ADRs automatically?▼

No. It only names ADR candidates as intent with title, decision, and rationale, echoed in an ADR promotion intent section. It never writes to the ADR directory or calls faff adr new; a later graft step materializes candidates.

Can I swap in a different architecture proposing strategy?▼

Yes. A swapped-in proposer, such as a cost-first or cloud-native strategy, conforms by emitting the same faff-contract:architecture-proposal block. The contract validates the envelope's shape while the producer owns the proposing strategy.

What are the limitations of the architecture proposal output?▼

The skill proposes but never commits, runs no review or verdict logic, and does not self-judge proposal quality. Production-grade assessment is a human gate, and non-build recommendations are surfaced for a human rather than actioned.