# Grace Init

> Bootstrap GRACE framework structure for a new project. Use when starting a new project with GRACE methodology - creates docs/ directory, AGENTS.md, and XML templates for requirements, technology, development plan, verification plan, knowledge graph, and operational packet contracts.

- **Type:** Skill
- **Install:** `agentstack add skill-osovv-grace-marketplace-grace-init`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [osovv](https://agentstack.voostack.com/s/osovv)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [osovv](https://github.com/osovv)
- **Source:** https://github.com/osovv/grace-marketplace/tree/main/skills/grace/grace-init

## Install

```sh
agentstack add skill-osovv-grace-marketplace-grace-init
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Initialize GRACE framework structure for this project.

## Template Files

All documents MUST be created from template files located in this skill's `assets/` directory.
Read each template file, replace the `$PLACEHOLDER` variables with actual values gathered from the user, and write the result to the target project path.

| Template source                          | Target in project           |
|------------------------------------------|-----------------------------|
| `assets/AGENTS.md.template`              | `AGENTS.md` (project root)  |
| `assets/docs/knowledge-graph.xml.template` | `docs/knowledge-graph.xml`  |
| `assets/docs/requirements.xml.template`    | `docs/requirements.xml`     |
| `assets/docs/technology.xml.template`      | `docs/technology.xml`       |
| `assets/docs/development-plan.xml.template`| `docs/development-plan.xml` |
| `assets/docs/verification-plan.xml.template`| `docs/verification-plan.xml` |
| `assets/docs/operational-packets.xml.template`| `docs/operational-packets.xml` |

> **Important:** Never hardcode template content inline. Always read from the `.template` files — they are the single source of truth for document structure.

## Steps

1. **Gather project info from the user.** Ask for:
   - Project name and short annotation
   - Main keywords (for domain activation)
   - Primary language, runtime, and framework (with versions)
   - Key libraries/dependencies (if known)
   - Testing stack (test runner, assertion style, mock/fake approach)
   - Observability stack (logger, structured log fields, redaction constraints)
   - High-level module list (if known)
   - 2-5 critical flows or risky surfaces that must be verifiable early

2. **Create `docs/` directory and populate documents from templates:**

    For each `assets/docs/*.xml.template` file:
    - Read the template file
   - Replace `$PLACEHOLDER` variables with user-provided values
   - Write the result to the corresponding `docs/` path

3. **Create or verify `AGENTS.md` at project root:**
    - If `AGENTS.md` does not exist — read `assets/AGENTS.md.template`, fill in `$KEYWORDS` and `$ANNOTATION`, and write to project root
    - If `AGENTS.md` already exists — warn the user and ask whether to overwrite or keep the existing one

4. **Print a summary** of all created files and suggest the next step:
    > "Run `$grace-plan` to design modules, data flows, and verification references. Then use `$grace-verification` to deepen tests, traces, and log-driven evidence before large execution waves. Use `docs/operational-packets.xml` as the canonical packet and delta reference during execution and refactors."

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [osovv](https://github.com/osovv)
- **Source:** [osovv/grace-marketplace](https://github.com/osovv/grace-marketplace)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-osovv-grace-marketplace-grace-init
- Seller: https://agentstack.voostack.com/s/osovv
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.