notque/vexjoy-agent / skills/content/writing
writing
UnverifiedWriting: voice creation and validation, prose editing, anti-AI cleanup, professional communication, translation.
references/pc-examples.md
View on GitHub# Professional Communication Transformation Examples
**Note**: Examples use SaaS/infrastructure context for illustration. The transformation patterns apply to any technical domain.
## Example 1: Multi-Propositional Sentence Processing
### Input (Dense Technical Update)
```
The rate limiter is still broken because it counts preflight OPTIONS requests against the quota, so if you have a frontend making CORS requests the API sees double the traffic and throttles legitimate calls even though the OPTIONS don't hit the backend, but I patched this in our custom middleware along with tons of other rate limiting edge cases to keep things more stable.
```
### Proposition Extraction
1. **Current Status**: Rate limiter broken
2. **Root Cause**: Counts preflight OPTIONS requests against quota
3. **Specific Bug**: CORS preflight requests inflate traffic count
4. **Behavioral Impact**: Legitimate API calls throttled prematurely
5. **Solution Implemented**: Fixed in custom middleware
6. **Scope of Fix**: Includes multiple other rate limiting edge cases
7. **Quality Goal**: Maintain system stability
### Structured Output
```markdown
**STATUS**: YELLOW
**KEY POINT**: Rate limiter bug causes premature throttling of legitimate requests, resolved in middleware patch
**Summary**:
- Core issue: Rate limiter counts preflight OPTIONS requests against client quotas
- Impact: Frontend applications with CORS see double-counted traffic, triggering false throttling
- Resolution: Custom middleware patch implemented alongside other rate limiting stability improvements
**Technical Details**:
Rate limiter incorrectly includes preflight OPTIONS requests in quota calculations, causing CORS-enabled frontends to consume quota at 2x the actual request rate. Middleware patch filters OPTIONS from quota counting and includes additional edge case handling.
**Next Steps**:
1. Document specific rate limiter fixes for upstream contribution to the cloud provider
2. Monitor throttling metrics for additional edge cases
3. Coordinate with the provider on quota calculation logic improvements
```
## Example 2: Stream-of-Consciousness Debugging Translation
### Input (Non-Linear Update)
```
Yeah the v2.1 migration script was an improvement but v2.2 rollback is massive, there were tons of foreign key constraint issues and orphaned records before but v2.2 rollback is cleaner than any point with our custom migration tooling, that's how much they improved it, though I'm sure I'll find more to fix since it's rare you just delete code because the platform handles it better now.
```
### Proposition Extraction
1. **Historical Context**: v2.1 migration showed incremental improvement
2. **Current Release**: v2.2 rollback represents major update
3. **Historical Problems**: Foreign key constraints and orphaned record issues existed
4. **Comparative Performance**: v2.2 exceeds custom migration tooling
5. **Quality Assessment**: Substantial improvement magnitude
6. **Future Expectation**: Additional improvements likely still possible
7. **Code Impact**: Platform improvements may allow custom tooling removal
### Structured Output
```markdown
**STATUS**: GREEN
**KEY POINT**: v2.2 rollback resolves critical foreign key constraint issues, exceeds custom tooling
**Summary**:
- v2.2 rollback released: Major improvements to database migration rollback systems
- Performance milestone: Platform tooling now exceeds custom migration implementation quality
- Historical issues: Foreign key constraints and orphaned record problems resolved
**Technical Details**:
Platform improvements in v2.2 have eliminated the need for custom rollback tooling that was previously required. Rollback performance now superior to any previous state including custom implementations.
**Next Steps**:
1. Evaluate remaining custom migration components for potential removal
2. Identify new improvement opportunities in updated platform tooling
3. Refactor migration scripts to leverage new platform capabilities where appropriate
```
## Example 3: Dependency Blocker Extraction
### Input (Defensive Constraint Explanation)
```
I can't implement certain features unless the vendor fixes their SDK, I don't say they have to do their job first but they do have to fix things I don't control, that's just accurate not demanding, the breaking changes in their latest release that have issues I cannot patch around, only the vendor can fix.
```
### Proposition Extraction
1. **Capability Limitation**: Multiple features blocked
2. **External Dependency**: Vendor controls required SDK
3. **Clarification Intent**: Not demanding priority, acknowledging constraints
4. **Technical Boundary**: No access to modify third-party SDK internals
5. **Scope Delineation**: Clear controllable vs. uncontrollable elements
6. **Tone Defense**: Defensive about being perceived as demanding
### Structured Output
```markdown
**STATUS**: YELLOW
**KEY POINT**: Multiple features blocked by third-party SDK breaking changes
**Summary**:
- Current blockers: Several planned features depend on SDK functionality broken in latest release
- Vendor dependency: Third-party vendor controls the SDK with breaking changes
- Workaround status: No alternative implementation paths available within current API surface
**Technical Details**:
SDK breaking changes are outside development team's control and require a vendor patch. Blocked features cannot proceed until the vendor releases a fixed SDK version.
**Next Steps**:
1. Document specific SDK limitations requiring vendor resolution
2. Continue development on features not dependent on broken SDK paths
3. Coordinate with vendor on SDK fix timeline and priority
4. Identify any possible workarounds for high-priority blocked features
```
## Example 4: Microservice Communication Failure
### Input (Multi-Hypothesis Technical Analysis)
```
I haven't addressed the issues you bring up with the order service timeouts, haven't touched that yet at all, it's on the things to do, it's driven by the async messaging layer, they could have been dropping messages during peak load, they could be misconfigured to not retry.
```
### Proposition Extraction
1. **Current Status**: Order service timeout issues not addressed
2. **Acknowledgment**: Issue recognition confirmed
3. **Backlog Status**: Added to development task list
4. **System Identification**: Async messaging layer involvement
5. **Hypothesis 1**: Messages dropped during peak load
6. **Hypothesis 2**: Retry configuration bug preventing delivery
### Structured Output
```markdown
**STATUS**: YELLOW
**KEY POINT**: Order service timeout issues identified but not yet addressed
**Summary**:
- Issue status: Confirmed timeout problems in async messaging layer
- Current focus: Issue added to development backlog for investigation
- Root cause: Two potential causes identified (message dropping or retry misconfiguration)
**Technical Details**:
Async messaging layer may be dropping messages during peak load or experiencing retry configuration issues that prevent reliable delivery to the order service. Investigation required to determine root cause.
**Next Steps**:
1. Investigate message throughput patterns in async messaging layer during peak load
2. Test retry configuration for potential misconfigurations affecting delivery
3. Implement fixes for confirmed root causes
4. Validate normal message delivery behavior post-fix
```
## Example 5: Crisis Communication Processing
### Input (Urgent Technical Issue)
```
The latest deploy broke CDN cache invalidation completely, stale assets are being served to all regions now and won't update, this affects every customer-facing page and it's breaking the checkout flow, I can work around it by busting caches manually but this needs an immediate rollback or hotfix.
```
### Proposition Extraction
1. **Severity**: Complete system failure
2. **System Affected**: CDN cache invalidation
3. **Behavioral Symptom**: Stale assets served, cache not clearing
4. **Scope**: All regions affected
5. **Impact**: Customer-facing pages and checkout flow disrupted
6. **Workaround Availability**: Manual cache busting possible
7. **Required Action**: Immediate rollback or hotfix urgency
### Structured Output
```markdown
**STATUS**: RED
**KEY POINT**: Critical CDN cache invalidation failure after deploy requires immediate action
**Summary**:
- Critical issue: CDN cache invalidation completely non-functional after latest deploy
- Impact scope: All regions affected, checkout flow broken for customers
- Workaround: Manual cache busting available but rollback or hotfix required
**Technical Details**:
Latest deploy introduced regression causing CDN cache invalidation to fail across all regions. Stale assets being served to all customer-facing pages, creating broken checkout experience.
**Next Steps**:
1. IMMEDIATE: Begin manual cache invalidation to mitigate customer impact
2. URGENT: Initiate deploy rollback or coordinate emergency hotfix
3. Document exact regression point and provide reproduction steps to CDN team
4. Test fix thoroughly before redeployment to prevent additional regressions
```
## Transformation Pattern Summary
### Multi-Propositional Sentences
- Extract 4-6 embedded facts per sentence
- Categorize by status/action/impact/blocker
- Apply priority ordering (business impact first)
- Preserve all technical accuracy
### Stream-of-Consciousness
- Parse chronologically to extract temporal flow
- Group related propositions together
- Linearize into sequential structure
- Maintain causal relationships
### Dependency Blockers
- Strip defensive or emotional language
- Extract specific constraints and dependencies
- Frame as neutral project status
- Provide clear next steps with ownership
### Crisis Communication
- Elevate severity appropriately (RED status)
- Front-load business impact
- Separate immediate vs. follow-up actions
- Maintain technical precision for resolution teams
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |