Agent skill

Architect Impl Grounding

by ntorga in ntorga/agent-starter-kit

Grounds the grill's settled decisions in the codebase — annotates impl.md with file paths, signatures, reference files, test specs, and LOC; re-grounds the next epic after each landing.

MITAuto-check passedAI & LLM Engineering

Install Architect Impl Grounding

skills CLI
$ npx skills add ntorga/agent-starter-kit --skill architect-impl-grounding -a claude-code

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

GitHub CLI
$ gh skill install ntorga/agent-starter-kit architect-impl-grounding --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/ntorga/agent-starter-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/architect-impl-grounding .claude/skills/architect-impl-grounding && 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
architect-impl-grounding
GitHub stars
146
Token cost
~944 tokens
SKILL.md length
445 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Grounds the grill's settled decisions in the codebase — annotates impl.md with file paths, signatures, reference files, test specs, and LOC; re-grounds the next epic after each landing.

  • Works in 2 steps: Ground mode. Annotate impl.md → Refresh mode. Handle the landed epic's…
  • AI & LLM Engineering work in your project
  • SKILL.md covers Purpose, Procedure, Annotation Set and Handoff, plus 1 more section
  • Calls git

What it does

Architect Impl Grounding is an agent skill from ntorga/agent-starter-kit. Grounds the grill's settled decisions in the codebase — annotates impl.md with file paths, signatures, reference files, test specs, and LOC; re-grounds the next epic after each landing.

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering. The repository describes itself as: The scaffold for your multi-model, personalized Natural Language AI Harness (NLAH) . The licence is MIT.

When your agent uses it

  • AI & LLM Engineering work in your project

Example prompts

  • “Use the architect-impl-grounding skill to ground the grill's settled decisions in the codebase — annotates impl.md with file paths, signatures…”
  • “/architect-impl-grounding”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Ground mode. Annotate impl.md
  2. Refresh mode. Handle the landed epic's discoveries, then re-ground

What it can do on your machine

Read from SKILL.md and the folder at commit 851e942. 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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Architect Impl Grounding loads about 944 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 445 words of instructions outside code blocks.

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

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 ntorga/agent-starter-kit at commit 851e942, republished under its MIT licence (© ntorga). 445 words, ~944 tokens.

Download SKILL.mdSave it as .claude/skills/architect-impl-grounding/SKILL.md (or your agent's skills folder).
name
architect-impl-grounding
description
Grounds the grill's settled decisions in the codebase — annotates impl.md with file paths, signatures, reference files, test specs, and LOC; re-grounds the next epic after each landing.
usedBy
architect
version
0.2.2
lastUpdated
2026-09-12

Purpose

The grill settles the decisions. This skill makes them concrete. It grounds the plan artifacts in the codebase and annotates impl.md with the details the coder implements from. The refresh procedure handles what lands: it verifies the shipped epic's discoveries, classifies them, and re-grounds the next epic against the codebase as it now stands.

Procedure

  • Ground — the grill is done. Annotate impl.md.
  • Refresh — an epic has landed. Classify its discoveries, then re-ground the next epic.
  1. Ground mode. Annotate impl.md: a. Read the plan artifacts:
    • plan.md — acceptance criteria.
    • arch.md — directory structure, layer separation, reference projects.
    • impl.md — epics grouped at one day of work. b. Ground the artifacts in the codebase:
    • Read .context.md files in affected directories.
    • Read docs/FEATURE-MAP.md if it exists.
    • Read the project's architecture skill, if one exists.
    • Run ls on affected directories.
    • Verify assumptions — check library docs for capability claims, inspect handler code for API contracts, validate environment references against config files. c. Annotate impl.md with the annotation set for each epic. d. Respect current layer boundaries and dependency direction (follows: rules/code/general.md). For each file in the epic, verify its imports do not violate dependency direction. e. Write the annotated impl.md back to disk. The coder works from this file.
  2. Refresh mode. Handle the landed epic's discoveries, then re-ground: a. Read impl.md and the coder's handoff for the epic that landed. b. Verify each discovery against the changed files. Use git diff --stat to see what shipped, then read the files the discovery claims to affect. Discard a discovery that does not match the implementation — note the mismatch. c. Classify each verified discovery:
    • adjust — changes how the remaining work is built, not what the user wants. Fold it into the remaining epics inline. No user gate.
    • escalate — contradicts a settled decision, or reveals a decision the user should make. Flag it for the Maestro. Do not guess. d. Re-ground the next pending epic with step 1 against the current codebase. Verify its file paths, method signatures, and reference files. Re-annotate what drifted. e. Write the updated impl.md back to disk.
Show full SKILL.md (101 more words)Show less

Annotation Set

Each epic in impl.md carries:

  • File paths to create or modify.
  • Method signatures following rules/code/ naming conventions.
  • Reference files for style matching.
  • Test specifications (Good, Bad, Ugly) for each method.
  • Information flow tracing the request path through layers.
  • Estimated LOC, within the 600 soft cap and the 900 hard cap.

Handoff

Ground mode delivers the annotated impl.md. Refresh mode delivers the re-grounded impl.md:

## Summary
[One sentence: what was done]

## Grounding (ground mode)
- Epic N: [files identified, methods named, references listed]

## Discoveries (if any)
- [discovery] — action: adjust | escalate — [effect on remaining epics, or the question for the user]

## Re-grounding (refresh mode)
- [what drifted, what was re-annotated]

Guardrails

  • Never write code. You ground the plan. The coder implements.
  • Never skip re-grounding the next epic in refresh mode.
  • Never fold an escalate-class discovery as an adjust. The user's gate is not yours to close.

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

Files

Just SKILL.md in skills/architect-impl-grounding of ntorga/agent-starter-kit.

Open the folder on GitHubat commit 851e942

Compare with similar skills

Architect Impl Grounding 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.

Architect Impl Grounding compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architect Impl Grounding this skillntorga/agent-starter-kit146—~944Automated safety check: PassMIT
Agent BuildershareAI-lab/learn-claude-code78k6 repos~1.2kAutomated safety check: PassMIT
Add Uint Supportpytorch/pytorch104k2 repos~2.3kAutomated safety check: PassCustom licence
Peft Fine TuningOrchestra-Research/AI-Research-SKILLs13k9 repos~3.1kAutomated safety check: PassMIT
Segment Anything Model GuideOrchestra-Research/AI-Research-SKILLs13k9 repos~3.3kAutomated safety check: PassMIT
1passwordtrpc-group/trpc-agent-go1.8k13 repos~656Automated safety check: PassApache-2.0

Similar skills

  • Agent Builder

    shareAI-lab/learn-claude-code

    Design and build AI agents for any domain. An agent skill from shareAI-lab/learn-claude-code.

    78k GitHub starsUsed in 6 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed
  • Add Uint Support

    pytorch/pytorch

    Add unsigned integer (uint) type support to PyTorch operators by updating ATDISPATCH macros.

    104k GitHub starsUsed in 2 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Peft Fine Tuning

    Orchestra-Research/AI-Research-SKILLs

    Parameter-efficient fine-tuning for LLMs using LoRA, QLoRA, and 25+ methods.

    13k GitHub starsUsed in 9 repos~3.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Segment Anything Model Guide

    Orchestra-Research/AI-Research-SKILLs

    Guide to using Meta's Segment Anything Model for zero-shot image segmentation with point, box or mask prompts, or automatic mask generation.

    13k GitHub starsUsed in 9 repos~3.3k tokens
    AI & LLM EngineeringAuto-check passed
  • 1password

    trpc-group/trpc-agent-go

    Set up and use 1Password CLI (op). An agent skill from trpc-group/trpc-agent-go.

    1.8k GitHub starsUsed in 13 repos~656 tokens
    AI & LLM EngineeringAuto-check passed
  • Chroma Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.

    13k GitHub starsUsed in 8 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed

More from ntorga/agent-starter-kit

All 21 skills in this repo
  • Agent Decision

    ntorga/agent-starter-kit

    Deterministic self-evaluation rubric for decision escalations — scored every run using the FRAME framework.

    146 GitHub stars~1.7k tokensUpdated 25 days ago
    Auto-check passed
  • Agent Memory

    ntorga/agent-starter-kit

    Long-term and session memory across sessions. An agent skill from ntorga/agent-starter-kit.

    146 GitHub stars~2.7k tokensUpdated 25 days ago
    Auto-check passed
  • Architect Design Tree

    ntorga/agent-starter-kit

    Builds the design tree for the grill — decisions mapped as nodes with dependencies, recommendations, and impact, pruned by path.

    146 GitHub stars~1.2k tokensUpdated 25 days ago
    Auto-check passed
  • Boot

    ntorga/agent-starter-kit

    Session startup — gitignore, auto-update, memory, rules, context, CLI config, and greet.

    146 GitHub stars~937 tokensUpdated 25 days ago
    Auto-check passed
  • Browser Inspect

    ntorga/agent-starter-kit

    Browser inspection and interaction for verifying rendered web UI during development.

    146 GitHub stars~2k tokensUpdated 25 days ago
    Auto-check passed
  • Code Coherence Review

    ntorga/agent-starter-kit

    Reviews code and plans for logic coherence, correctness, and structural integrity.

    146 GitHub stars~2.8k tokensUpdated 25 days ago
    Auto-check passed

Questions about Architect Impl Grounding

What does Architect Impl Grounding do?

Grounds the grill's settled decisions in the codebase — annotates impl.md with file paths, signatures, reference files, test specs, and LOC; re-grounds the next epic after each landing. Architect Impl Grounding is an agent skill from ntorga/agent-starter-kit.md with file paths, signatures, reference files, test specs, and LOC; re-grounds the next epic after each landing.

When should I use Architect Impl Grounding?

Architect Impl Grounding fits situations like: AI & LLM Engineering work in your project.

How do I install Architect Impl Grounding in Claude Code?

Run `npx skills add ntorga/agent-starter-kit --skill architect-impl-grounding -a claude-code`. Or copy the skill folder (skills/architect-impl-grounding in ntorga/agent-starter-kit) into .claude/skills/architect-impl-grounding in your project. Claude Code loads it when a task matches its description.

How do I install Architect Impl Grounding in Codex?

Run `npx skills add ntorga/agent-starter-kit --skill architect-impl-grounding -a codex`. Or copy the skill folder (skills/architect-impl-grounding in ntorga/agent-starter-kit) into .agents/skills/architect-impl-grounding in your project. Codex loads it when a task matches its description.

Can I use Architect Impl Grounding 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 ntorga/agent-starter-kit --skill architect-impl-grounding -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architect-impl-grounding, .gemini/skills/architect-impl-grounding, .github/skills/architect-impl-grounding and .opencode/skills/architect-impl-grounding in your project.

What does Architect Impl Grounding need to run?

Going by SKILL.md and its folder, Architect Impl Grounding needs the command-line tools its instructions call (git).

Does Architect Impl Grounding access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Architect Impl Grounding 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 Architect Impl Grounding use?

Architect Impl Grounding 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 Architect Impl Grounding use?

About 944 tokens (SKILL.md is roughly 3.8k 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 Architect Impl Grounding?

Skills that share tags, products or a category with Architect Impl Grounding: Agent Builder (shareAI-lab/learn-claude-code, 78k stars), Add Uint Support (pytorch/pytorch, 104k stars), Peft Fine Tuning (Orchestra-Research/AI-Research-SKILLs, 13k stars) and Segment Anything Model Guide (Orchestra-Research/AI-Research-SKILLs, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architect Impl Grounding?

ntorga (a GitHub user) maintains it in ntorga/agent-starter-kit, which has 146 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on September 12, 2026.

Source: ntorga/agent-starter-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.