# Specx Foundation

> Use specx foundation bases in Python services, or add a tiny project-local `foundation/` base for missing categories or stateful framework bases.

- **Type:** Skill
- **Install:** `agentstack add skill-maksimzayats-specx-specx-foundation`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [maksimzayats](https://agentstack.voostack.com/s/maksimzayats)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [maksimzayats](https://github.com/maksimzayats)
- **Source:** https://github.com/maksimzayats/specx/tree/main/skills/specx-foundation
- **Website:** https://specx.dev

## Install

```sh
agentstack add skill-maksimzayats-specx-specx-foundation
```

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

## About

# specx Foundation

Use this skill when a service class needs an explicit base, or when a new class
category may need a project-local foundation base. Read
`references/foundation.md` before editing foundation-related code.

## Workflow

1. Prefer packaged scoped bases from `specx.core.foundation`,
   `specx.delivery.foundation`, and `specx.infrastructure.foundation`.
2. Do not create an empty `src//foundation/` package.
3. Add a project-local `foundation/` module only when current code needs a real
   project-local base category or a stateful framework base that must not be
   shared globally, such as a SQLAlchemy declarative base.
4. Keep project-local foundation limited to base definitions: marker bases,
   common external-base wrappers, justified ABCs, and stateful framework bases.
   Put stable cross-scope concrete primitives under `shared/`, not
   `foundation/`.
5. Give every project source class, including each local base, a docstring that
   explains what it protects and includes a concrete usage example.
6. Make every non-foundation project source class inherit an explicit scoped
   base.
7. Name each class with the suffix implied by its base ancestry, such as
   `TaskDTO`, `TaskEntity`, `TaskResponseSchema`, `CreateTaskUseCase`, or
   `TaskTitleNormalizerService`.
8. Use `BaseLifecycle` for delivery app lifespan managers such as
   `FastAPILifecycle`.
9. Prefer `@dataclass(frozen=True, kw_only=True, slots=True)` for commands,
   queries, DTOs, entities, and other core data classes unless the user asks for
   another model type.
10. Keep `BaseCommand` and `BaseQuery` as use-case input bases, independent from
   `BaseDTO`. Commands and queries are not result DTOs.
11. When an application value has a limited known set, model it with
    `BaseStrEnum` instead of plain `str` or `Literal[...]`.
12. Keep business rules, delivery behavior, adapter code, and runtime wiring out
    of project-local foundation modules.

## Code Style

Use blank lines as logical separators in all code. Keep related statements
together, but separate independent setup, action, assertion, response, branch,
and transformation groups so long blocks stay readable.

## References

- `references/foundation.md` - packaged base catalog, import paths, extension
  rules, and architecture guardrails.

## Source & license

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

- **Author:** [maksimzayats](https://github.com/maksimzayats)
- **Source:** [maksimzayats/specx](https://github.com/maksimzayats/specx)
- **License:** MIT
- **Homepage:** https://specx.dev

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-maksimzayats-specx-specx-foundation
- Seller: https://agentstack.voostack.com/s/maksimzayats
- 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%.