Agent skill

Architecture Aware Init

by athola in athola/claude-night-market

Selects architecture paradigm via research before scaffolding.

MITAuto-check passedDevelopment

Install Architecture Aware Init

skills CLI
$ npx skills add athola/claude-night-market --skill architecture-aware-init -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install athola/claude-night-market architecture-aware-init --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/athola/claude-night-market.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/attune/skills/architecture-aware-init .claude/skills/architecture-aware-init && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
architecture-aware-init
GitHub stars
341
Token cost
~1.5k tokens
SKILL.md length
549 words
Files
5
Skills in repo
154
Repo updated
First seen
Licence
MIT

At a glance

Selects architecture paradigm via research before scaffolding.

  • Works in 2 steps: Select the architecture paradigm → 5: Customize templates and record the…
  • Architecture is undecided and the choice needs justification and documentation
  • SKILL.md covers Overview, When To Use This Skill, Required TodoWrite Items and 5-Step Workflow, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architecture Aware Init is an agent skill from athola/claude-night-market. Selects architecture paradigm via research before scaffolding. Use when architecture is undecided and the choice needs justification and documentation.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `modules/paradigm-selection.md`, `modules/research-flow.md` and `modules/scaffold-generation.md`).

It sits in Development, covering Project scaffolding. The repository describes itself as: 23 Claude Code plugins: TDD enforcement hooks, git/PR workflows, spec-driven development, code review, project lifecycle, fix-from-error, maintenance automation, context… The licence is MIT.

When your agent uses it

  • Architecture is undecided and the choice needs justification and documentation
  • Tasks that involve Project scaffolding

Example prompts

  • “Use the architecture-aware-init skill to select architecture paradigm via research before scaffolding”
  • “/architecture-aware-init”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Select the architecture paradigm
  2. 5: Customize templates and record the decision

What it can do on your machine

Read from SKILL.md and the folder at commit 9f3eb00. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Architecture Aware Init loads about 1.5k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 549 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from athola/claude-night-market at commit 9f3eb00, republished under its MIT licence (© athola). 549 words, ~1,498 tokens.

Download SKILL.mdSave it as .claude/skills/architecture-aware-init/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
architecture-aware-init
description
Selects architecture paradigm via research before scaffolding. Use when architecture is undecided and the choice needs justification and documentation.
alwaysApply
false
category
project-initialization
tags
architecture, initialization, research, decision-making, best-practices
dependencies
archetypes:architecture-paradigms
usage_patterns
new-project-setup, architecture-selection, best-practices-research, template-customization
complexity
advanced
model_hint
deep
estimated_tokens
1800
progressive_loading
true
modules
modules/research-flow.md, modules/paradigm-selection.md, modules/scaffold-generation.md, modules/script-integration.md

Architecture-Aware Project Initialization

Overview

Project initialization that combines online research, archetype selection, template customization, and decision documentation into one workflow. Use this skill when the architecture is undecided and the choice deserves justification.

When To Use This Skill

  • Starting a new project and unsure which architecture fits best
  • Wanting modern, industry-standard architecture choices
  • Needing justification for architectural decisions
  • Wanting templates customized to the chosen paradigm

Use instead of project-init when architecture is undecided. Use before project-specification to establish the architectural foundation.

Required TodoWrite Items

  1. arch-init:research-completed: Online research completed
  2. arch-init:paradigm-selected: Architecture paradigm chosen
  3. arch-init:templates-customized: Templates adapted to paradigm
  4. arch-init:decision-recorded: ADR created

5-Step Workflow

Steps 1-2: Gather context, research best practices

Load modules/research-flow.md for the full project-context questionnaire and the three-tier search strategy. Output: a synthesis brief that feeds Step 3.

Step 3: Select the architecture paradigm

Load modules/paradigm-selection.md for the decision matrix (team size by domain complexity) and the special-case overrides (streaming, serverless, microkernel, etc.). Two routes:

  • Use the archetypes:architecture-paradigms skill for guided exploration.
  • Use the matrix directly for a fast recommendation.
Step 4-5: Customize templates and record the decision

Load modules/scaffold-generation.md for the paradigm-specific directory layouts (Functional Core / Hexagonal / Microservices shown; others delegated to the corresponding archetypes:architecture-paradigm-{name} skill) and the ADR template.

Output: Initialization Package

After completing the workflow, the project has:

  1. A directory structure matched to the chosen architecture
  2. Configuration that reflects the paradigm (test layout, tooling, dependency hints)
  3. An ADR explaining why this paradigm was chosen
  4. Links to the relevant paradigm skill for ongoing implementation guidance
  5. References to similar real-world projects from Step 2

Script Integration

The interactive workflow above is the default. For automation, load modules/script-integration.md for the three Python helpers under plugins/attune/scripts/ (architecture researcher, template customizer, full interactive flow) and library-style import examples.

Integration with Existing Commands

This skill enhances /attune:project-init by adding an architecture-selection phase before scaffolding:

bash
# Standard initialization (no architecture decision)
/attune:project-init --lang python --name my-project

# Architecture-aware initialization
/attune:brainstorm                  # Explore project needs
Skill(architecture-aware-init)      # Select architecture
/attune:project-init --arch <paradigm> --name my-project
Show full SKILL.md (238 more words)Show less

Example Session

User: "I'm creating a Python web API for a fintech application. Team of 8 developers, complex business rules, need high security and audit trails."

  • Step 1 context: Web API, highly complex domain, 5-15 engineers, security and auditability requirements.
  • Step 2 research: queries for fintech API patterns, audit-trail architecture, CQRS+ES Python examples.
  • Step 3 selection: research plus decision matrix yields CQRS + Event Sourcing.
  • Step 4 templates: command-handler module, query-handler module, event store, aggregate patterns, projection handlers.
  • Step 5 ADR: documents why CQRS/ES fits (auditability, complex rules, regulatory compliance).

Result: project initialized with paradigm-appropriate structure and clear decision rationale.

  • Skill(archetypes:architecture-paradigms): paradigm catalog
  • Skill(archetypes:architecture-paradigm-*): per-paradigm implementation guidance
  • Skill(attune:project-brainstorming): ideation before architecture
  • Skill(attune:project-specification): requirements after the paradigm is chosen

See Also

  • /attune:project-init: basic project initialization
  • /attune:blueprint: architecture planning after paradigm selection
  • plugins/archetypes/README.md: full paradigm reference

Exit Criteria

  • All four TodoWrite items are checked off: arch-init:research-completed, arch-init:paradigm-selected, arch-init:templates-customized, arch-init:decision-recorded.
  • An ADR file exists in the initialized project explaining why the selected paradigm was chosen, referencing evidence from the Step 2 research synthesis.
  • The project directory structure matches the layout prescribed by the chosen archetypes:architecture-paradigm-* skill (verified by listing the created directories).
  • If the paradigm is undecided after research, the skill surfaces the top two candidates with trade-offs and waits for explicit user selection rather than defaulting silently.
  • When research ran, research.json holds preferred and avoid lists and was passed with --research-file; the recommendation's rationale contains a rule naming "research"

© athola, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in plugins/attune/skills/architecture-aware-init of athola/claude-night-market.

  • SKILL.md
  • modules/paradigm-selection.md
  • modules/research-flow.md
  • modules/scaffold-generation.md
  • modules/script-integration.md

Open the folder on GitHubat commit 9f3eb00

Compare with similar skills

Architecture Aware Init next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Architecture Aware Init compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture Aware Init this skillathola/claude-night-market341—~1.5kAutomated safety check: PassMIT
Nx Generatenomcopter/react-mosaic4.8k7 repos~1.9kAutomated safety check: PassCustom licence
PonytailDavidObando/gsharp5648 repos~1.7kAutomated safety check: PassMIT
Run Nx Generatornrwl/nx29k2 repos~592Automated safety check: NotesMIT
Conductor Setupgemini-cli-extensions/conductor3.8k—~4.2kAutomated safety check: PassApache-2.0
Mirage VFS Adapter Authoringstrukto-ai/mirage3.7k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Nx Generate

    nomcopter/react-mosaic

    Generate code using nx generators. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 7 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Ponytail

    DavidObando/gsharp

    Forces the laziest solution that actually works, simplest, shortest, most minimal.

    564 GitHub starsUsed in 8 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Run Nx generators with prioritization for workspace-plugin generators.

    29k GitHub starsUsed in 2 repos~592 tokens
    DevelopmentAuto-check: notes
  • Conductor Setup

    gemini-cli-extensions/conductor

    Scaffolds the project and sets up the Conductor environment.

    3.8k GitHub stars~4.2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Builds or extends a custom Mirage virtual filesystem adapter for an API, database, object store or app data, with a working mount configuration and filesystem tests.

    3.7k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Enforces this repository's TypeScript backend module architecture under server/: feature folders, barrel exports, and where shared types and utilities belong.

    14k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from athola/claude-night-market

All 154 skills in this repo
  • Night Market Diagnostics Toolkit

    athola/claude-night-market

    Run and interpret repo diagnostic scripts (ratchets, validators, token stats).

    341 GitHub stars~3.4k tokensUpdated 3 days ago
    Auto-check passed
  • Skills Eval

    athola/claude-night-market

    Evaluate Claude skill quality through auditing. An agent skill from athola/claude-night-market.

    341 GitHub stars~1.6k tokensUpdated 3 days ago
    Auto-check passed
  • Agent Teams

    athola/claude-night-market

    Coordinates Claude agent teams via filesystem protocol. An agent skill from athola/claude-night-market.

    341 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • Delegation Core

    athola/claude-night-market

    Delegates execution to eight CLIs (Gemini, Qwen, MiniMax, GLM, Muse, Codex, OpenCode, Glimmer).

    341 GitHub stars~2.5k tokensUpdated 3 days ago
    Auto-check passed
  • Elegant Code

    athola/claude-night-market

    Guide minimal code via a decision ladder with full safety, edge, and negative-case coverage.

    341 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed
  • Skill Library Mission

    athola/claude-night-market

    Build a project skill library in .claude/skills/ via discovery, parallel authoring, and review.

    341 GitHub stars~1.6k tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Architecture Aware Init

What does Architecture Aware Init do?

Selects architecture paradigm via research before scaffolding. Architecture Aware Init is an agent skill from athola/claude-night-market. Selects architecture paradigm via research before scaffolding.

When should I use Architecture Aware Init?

Architecture Aware Init fits situations like: architecture is undecided and the choice needs justification and documentation; tasks that involve Project scaffolding.

How do I install Architecture Aware Init in Claude Code?

Run `npx skills add athola/claude-night-market --skill architecture-aware-init -a claude-code`. Or copy the skill folder (plugins/attune/skills/architecture-aware-init in athola/claude-night-market) into .claude/skills/architecture-aware-init in your project. Claude Code loads it when a task matches its description.

How do I install Architecture Aware Init in Codex?

Run `npx skills add athola/claude-night-market --skill architecture-aware-init -a codex`. Or copy the skill folder (plugins/attune/skills/architecture-aware-init in athola/claude-night-market) into .agents/skills/architecture-aware-init in your project. Codex loads it when a task matches its description.

Can I use Architecture Aware Init in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add athola/claude-night-market --skill architecture-aware-init -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture-aware-init, .gemini/skills/architecture-aware-init, .github/skills/architecture-aware-init and .opencode/skills/architecture-aware-init in your project.

What does Architecture Aware Init need to run?

SKILL.md names no scripts, command-line tools or credentials: Architecture Aware Init is instructions for the agent only. Our summary lists: Python 3.

Does Architecture Aware Init access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Architecture Aware Init safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Architecture Aware Init use?

Architecture Aware Init is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Architecture Aware Init use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Architecture Aware Init?

Skills that share tags, products or a category with Architecture Aware Init: Nx Generate (nomcopter/react-mosaic, 4.8k stars), Ponytail (DavidObando/gsharp, 564 stars), Run Nx Generator (nrwl/nx, 29k stars) and Conductor Setup (gemini-cli-extensions/conductor, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture Aware Init?

athola (a GitHub user) maintains it in athola/claude-night-market, which has 341 GitHub stars. The repository holds 154 skills in this directory. The repository was last updated on October 6, 2026.

Source: athola/claude-night-market on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.