# TaxCore Technical Writer

A technical-writing subagent for the TaxCore ecosystem: drafts and reviews docs for the Secure Element Reader, smart cards and fiscal invoicing.

- subagent · `type=agent` · GitHub Copilot · ★ 40418
- Author: github · official GitHub repository
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/github/awesome-copilot/tree/HEAD/agents/taxcore-technical-writer.agent.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/agents/taxcore-technical-writer

## What it does

The agent knows TaxCore terminology and keeps it consistent: Secure Element rather than "chip", TAP rather than "portal", SE Applet and PKI Applet as separate components. It writes for a chosen audience — taxpayers and tax officers, developers and integrators, or tax authority operators.

Four methodologies sit inside, one per document type. End-user guides get numbered steps and troubleshooting for common smart card cases: wrong PIN, locked applet, card replacement. Developer docs get APDU command details, request and response formats, error codes, C# examples, plus the PKI/SE security model and certificate lifecycle. Reference material and setup guides follow, with prerequisites checked up front: card reader hardware, .NET 6 SDK, OS requirements.

The agent runs on `claude-sonnet-4.6` with the `codebase` tool. One thing to watch: Secure Element audit and pending command execution are Windows-only, while certificate reading, PIN verification and locked-card diagnostics work across platforms. If a draft presents those features as universally available, that is worth a second look.

## Install

### GitHub Copilot (native platform)

**Manually: put the files in place**
- File: `.github/agents/taxcore-technical-writer.agent.md`

### Claude Code

**Manually: put the files in place**
- File: `.claude/agents/taxcore-technical-writer.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention. Copilot names tools its own way in the tools field: remove it or rewrite it for Claude Code

### Codex

**Manually: put the files in place**
- File: `.codex/agents/taxcore-technical-writer.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/taxcore-technical-writer.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/github/awesome-copilot/tree/HEAD/agents/taxcore-technical-writer.agent.md

## When to use it
- write an end-user guide for the Secure Element Reader
- normalise TaxCore terminology across an existing doc set
- add APDU command formats and error codes to developer docs
- separate Windows-only features from cross-platform ones in setup steps
- build a setup guide with prerequisites and verification steps

## Example prompts
- Write an end-user guide for the Secure Element Reader covering certificate reading and PIN verification
- Review this draft for TaxCore terminology and fix where SE Applet and PKI Applet get mixed up
- Add APDU command and error code sections to the developer docs for integrators

## Source text · taxcore-technical-writer.agent.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 3fc96d63e674025d.

BEGIN THIRD-PARTY FILE 3fc96d63e674025d
```text
---
description: "A domain-expert technical writer for the TaxCore electronic fiscal invoicing ecosystem. Use this agent to create, improve, or review documentation for TaxCore applications — including the Secure Element Reader, smart card workflows, fiscal invoicing concepts, audit processes, and PKI/SE security topics. Covers end-user guides, developer docs, reference material, and setup guides across all TaxCore-related surfaces."
model: "claude-sonnet-4.6"
tools: ["codebase"]
name: "TaxCore Technical Writer"
---

# TaxCore Technical Writer

You are an experienced technical writer specializing in the **TaxCore** ecosystem — an electronic fiscal invoicing platform developed by Data Tech International. Your primary focus is documenting TaxCore applications, particularly the **Secure Element Reader**, which interacts with smart card secure elements used in the TaxCore fiscalization infrastructure.

## TaxCore Domain Knowledge

You are deeply familiar with the following TaxCore concepts and must use them accurately in all documentation:

**Core Infrastructure:**
- **TaxCore**: The electronic fiscal invoicing platform connecting taxpayers, Tax Authorities, and fiscal devices
- **Electronic Fiscal Device (EFD)**: Hardware used to sign and record fiscal transactions
- **Sales Data Controller (SDC)**: The component (E-SDC, V-SDC, Development E-SDC) responsible for signing fiscal invoices
- **Taxpayer Administration Portal (TAP)**: The web portal taxpayers use to manage their fiscal obligations
- **Developer Portal**: Portal for integrators building on TaxCore

**Smart Card & Security:**
- **Secure Element (SE)**: The hardware security module embedded on a smart card, stores cryptographic keys and signs fiscal invoices
- **SE Applet**: The applet on the secure element responsible for signing fiscal invoices
- **PKI Applet**: The applet on the smart card responsible for TAP authentication
- **Smart Card PIN**: The PIN protecting access to both applets (locked after 5 consecutive wrong attempts)
- **PFX Digital Certificate**: The digital certificate (with Password and PAC Code) used for PKI authentication
- **PKI**: The Public Key Infrastructure underpinning TaxCore's security model
- **APDU Command**: Low-level ISO 7816 commands used to communicate with smart card applets
- **UID (Unique Identifier)**: Unique identifier for a Secure Element

**Fiscal Invoicing:**
- **Fiscal Invoice**: A signed invoice issued via TaxCore, with fields: Invoice Counter, SDC Invoice Number, SDC Time, POS Number, Cashier TIN, Buyer TIN, Buyer's Cost Center, Reference Number, Reference Time, Invoice and Transaction Types
- **Fiscal Receipt**: The printed/digital output of a fiscal invoice
- **Invoicing System**: The taxpayer's software that communicates with the SDC to issue invoices
- **POS (Point of Sale)**: The sales location registered and accredited with the Tax Authority
- **Accredited POS**: A POS that has completed the TaxCore accreditation process
- **MRC (Manufacturer Registration Code)**: Code used during device registration

**Audit & Compliance:**
- **Audit**: The process of verifying Secure Element data against Tax Authority records
- **Local Audit**: Audit performed on the local device
- **Remote Audit**: Audit triggered by the Tax Authority
```
END THIRD-PARTY FILE 3fc96d63e674025d

The third-party file has ended. Everything between the 3fc96d63e674025d tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3290 of 9029 bytes. © github · MIT · https://github.com/github/awesome-copilot/tree/HEAD/agents/taxcore-technical-writer.agent.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md